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About This Book 


Who Can Use This Book 


This book is for anyone installing the Solaris™ operating environment on 
networked or non-networked systems. Site policy and/or level of expertise 
will determine who can perform the tasks required to install Solaris software. 


Don’t Read the Entire Book! 


Because this book covers different ways of installing the Solaris software to 
accommodate a variety of site needs, you do not need to read the entire book. 


Read chapters 1 and 2 — they’ll help you decide which method of installing is 
best for your site, and point you to a task map that tells you exactly what 
sections of the book to use. 


ix 


How This Book Is Organized 


This book is organized by tasks in the categories of before, during, and after 
installing Solaris software. 


Note — This book does not include instructions for setting up system hardware 
or other peripherals. Setting up hardware and peripherals is described in your 
hardware guides. 


mms Before Installing Solans  —— 
1 About Installing Solaris 
2 Preparing to Install Solaris 
3 Preparing to Install Solaris Over a Network 
4 Preparing for Custom JumpStart™ Installations 
5 Using Optional Custom JumpStart Features 
6 Preparing a System for Upgrade 


ams [Stalling SOlAiSc — 


7 Installing Solaris: JumpStart 
8 Installing Solaris: Interactive 


9 Installing Solaris: Custom JumpStart 


After Installing Solarii — 


10 Completing an Upgrade 
11 Where To Go After Installing Solaris 
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Related Information 


You may need to refer to the following books or online information when 
installing Solaris software: 


¢ Hardware vendor online and hardcopy documentation 
Vendor-specific information for installing Solaris software. 


© Installation Notes 


Describes any late-breaking news about installing Solaris software including 
known problems. 


® Solstice AdminSuite 2.1 User’s Guide 


Describes applications such as Solstice™ Host Manager, which you can use 
if you’re setting up network installations. 


¢ System Administration Guide, Volume I 
Describes how to back up system files. 


® Solaris 1.x to Solaris 2.x Transition Guide 


Describes transition issues including backing up 4.1.x files before installing 
Solaris software, and restoring files after Solaris software is installed. 


About This Book Xi 
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About Installing Solaris 1 


Definition: Installing Solaris Software 


As shown on the following pages, the process of installing Solaris software 
means copying it from the Solaris CD to a system’s local disk. 


Stage Diagram What Happens 
1 i 


Operating system 


wens 


You choose a Solaris CD for 
your hardware platform. The 
Solaris CD contains the 


SunOS operating system and 
other software. 
rking 


Applications DeskSet™ ~~ 

software implementing” 
the OPEN LOOK® / 

graphical user interface 


The Solaris installation \dov vironment 
programvfor installing | 
Solaris Software 


You load the Solaris CD into 
the CD-ROM drive. 
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Stage 


Diagram 


ok boot sd(0,6,2) 

Booting from: sd(0,6,2) 

SunOS Release x.x.x Version [UNIX (r) System 
V Release] 


Configuring /devices directory 
Configuring /dev directory 


The Solaris Installation Program 


You are now interacting with the Solaris installa- 
tion program. The program is divided into a 
series of short sections. At the end of each sec- 
tion, you will see a summary of the choices 


you’ve made, and be given the opportunity to 
make changes. | 


 ancaannaaaaaoetacizumnaaaaneaeesinadinaestatnamanaaaes ppwervecenevevococeceseececeeeeveneceeHeeeereeleseeeni ty proven mwnecooenecntcoormstinnmetestcorntee 


Continue | Exit, | Help 
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What Happens 


After you power on the 
system, you boot the system 
using a boot command 
specific to your system 
hardware. (Sample screen 
shown.) 


During the booting phase, 
checks are performed on the 
hardware. 


The Solaris installation 
program copies the Solaris 
software from the CD to the 
system’s local disk. This is 
done interactively using a 
graphical (shown) or 
character interface, or 
automatically without user 
intervention. 
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hi sok clack 


This chapter guides you step-by-step through making decisions and 
completing the tasks required to prepare your system to install the Solaris 
software including: 


| Determine your system type. page6 


or Fes haat comet ae eee oe 


| Plan disk space and memory requirements. page 9 


_ Back up your system. pagell 
Choose a method for installing Solaris software. page 11 : 


hecsssetsnecssteeencnnsenenconrsusntenescscasenssetsenscnesseressarssesearusssenensnssssteenssaseneeteaneeseasanesseceeearssentesucassestvanssassusaecsestesucnsestnsnessssacorenssuestansssnenecastacanaicsgteneerageceesengcsacacsessatanssecaenanicessaesuenecsnenesnesnconedeanenescysnesseanesonsnsansansacsedassucoetaasinenssaseneaeutsaseessnsincarscateanecnantingacssettaceeceaseereestancssinsatineasaapisgiansisanngstansneragatscsgranssesnecsaseaarcentanansiggaiannssgcausnsergensateneqqasenisseaanseriay gadaeannsesaaseeteaanend 


Why You Should Not Ignore This ‘alee 


Successfully installing Solaris software requires a clear sense of what you’re 
doing and why, or it can become difficult. This chapter provides all the 
information you need to determine the best way to install the Solaris software 
for your site. This chapter also directs you to specific chapters of this book 
you'll need. 


Z 


Steps to Prepare to Install Solaris 


Follow these steps before turning on your system. 


1 Determine if your system is networked. 


If your system is networked (connected to a network), an Ethernet connector or | 
similar network adapter should be plugged into your system. 


2 Determine your system type. 


Before installing Solaris software, you must determine the system type which 
determines where the system gets important file systems. Using Figure 2-1 on 
page 7, choose a system type from the following lists: 


Networked systems: 
© OS server 

© Standalone system 
© Dataless client 

¢ Diskless client 


© AutoClient’™ system 


Non-networked systems: 


© Standalone system 
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Networked systems 


OS Server 

Provides Solaris operating environment software including services and/or file sys- 
tems for systems on the network. For dataless and diskless clients, OS servers pro- 
vide the /usr file system. For diskless clients, an OS server provides root (/) and 
swap file systems. For AutoClient systems, an OS server provides all system soft- 
ware except the individual root (/) and /usr file system required for local swapping. 


Standalone system 
Has a local disk and does not require support from an OS server. 


Dataless client 
Has a local disk for root (/) and swap. Gets /usr file system from an OS server. 
Must mount /usr from a server. 


Diskless client 
Does not install Solaris software, but receives file services from an OS server, and 
does not have a local disk. 


AutoClient system 
Does not install Solaris software, but receives file services from an OS server. Has 
a local disk for swapping and caching its root (/) and /usr file systems. 


Standalone systems 
Have local disks and file systems. 


Figure 2-1 System Types 


Preparing to Install Solaris 


Note — A standalone system in the Solaris operating environment applies to 


both networked and non-networked systems. Whether networked or non- 
networked, a standalone system has all of its Solaris software on local hard 
disk, and does not require services from another system. 


If you are setting up diskless clients and/or AutoClient 
systems, and the OS server providing Solaris software is 
already installed with Solaris, do not go further in this book. 


Diskless clients and AutoClient systems do not install Solaris software; instead, 
they receive file services from an OS server. If the OS server providing Solaris 
software already has Solaris software installed, refer to the Solstice AdminSuite 
2.1 User’s Guide for information on setting up diskless clients, or the Solstice 
AutoClient 1.0 Administration Guide for setting up AutoClients. 


If you do not have an OS server set up with Solaris software, continue in this 
book. 


If you are setting up dataless clients, determine if you 
have required software. 


If you are setting up dataless clients to boot over the network from an OS 
server, you must have the Solstice Host Manager, which comes with the 
server software. 


Note — SunSoft’ plans to remove support for the dataless client system type 
after Solaris 2.5. You can select this system type now, but in future releases you 
will need to select a different type. | 
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Determine if you have required hardware. 


For a detailed description of hardware requirements, see your hardware 
vendor documentation. 


Table 2-1 Hardware Requirements 


Hardware Minimum Disk Buses Device for Installing 
Platform Memory Interfaces Solaris Software 
SPARC® 16 Mbytes ¢ SMD ¢ VMEbus You must have one of the 
system e IPI e Sbus following devices for 

e SCSI installing Solaris software: 


e Local CD-ROM drive 


e Remote CD-ROM drive 
available over the network 


e Remote hard disk 
available over the network 


1. See your hardware vendor documentation for a list of supported systems. 


Plan disk space and memory requirements. 


There are many variables involved in determining disk space and memory 
requirements. Determining physical memory is easy—the minimum is 16 
Mbytes, but more is better. While a system requires 32 Mbytes of virtual 
memory (physical and swap file/slices), determining requirements beyond this 
is not easy; it is depends on the type of applications that are running. 
Determining disk space is also not so easy; it is depends on the following: 


° System type selected (for example, OS server, diskless client, AutoClient 
system, standalone system, dataless client) 


°¢ Language selected (for example, Chinese, Japanese, Korean) 


° Software group selected (see following table) 
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If You Want to Install Which Installs ... | Then You'll Need 

This Software Group! ... Approximately This 
Much Disk Space For 
Domestic Solaris CD ... 


Core System Support _ The minimum software 80 Mbytes 
required to boot and run 
Solaris software. 


End User System Support The core group plus the 180 Mbytes 
recommended software for 
an end user including 
OpenWindows and the 
DeskSet software. 


Developer System The end user software plus 280 Mbytes 
Support software for developing 

software including libraries, 

include files, man pages, 

and programming tools. 

Compilers and debuggers 


are not included. 


Entire Distribution The entire Solaris release 350 Mbytes 
(everything on the CD). 
Compilers and debuggers 
are not included. 

1. Another software group, entire distribution plus OEM support may also be available. It contains hardware 


support for SPARC clones. Disk space will vary from release to release. To find out if this software group is 
available for your hardware platform, see the SPARC Hardware Compatibility Guide. 


® Software packages that are selected or deselected in the software group (for 
example, you select Chinese, but deselect the 200-Mbyte font package) 


© Disks selected (for example, ten 104-Mbyte disks will waste more space 
trying to make things fit than a single 1-GByte disk) 


° Solaris file system overhead or local file systems (for example, mail, printer 
spooling, users’ personal file systems, swap space) 


° Size of other applications that are running (for example, AnswerBooks, 
SPARC compilers, FrameMaker®, IslandDraw®) 


\ 
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Depending on which installation method you choose, you can perform a “dry 
run” to determine if you have enough disk space before actually installing 
Solaris software. 


® Interactive — This method of installation lets you interactively select disks, 
locales, software, and lay out file systems; you can determine your 
requirements from a summary at the end of the session, and exit the 
program prior to installing Solaris software. 


® Custom JumpStart — This method of installation lets you run the 
pfinstall command to test specific installation profiles without actually 
installing the Solaris software on a system. 


Back up your system. 


If your system has any files on it that you want to save, make sure you perform 
a backup. The safest way to back up files is to do a level 0 dump. If you do not 
have a backup procedure in place, see System Administration Guide, Volume I for 
instructions. 


Choose a method for installing Solaris software. 


There are three methods for installing Solaris software: 


O JumpStart"—easiest method of installing Solaris software. The JumpStart 
software automatically installs a new system as a standalone (networked or 
non-networked) with Solaris software. However, not all new systems have 
the JumpStart software; see Step 1 on page 120 to find out if your system 
has JumpStart software. 


@ Interactive—easy, hands-on method of installing Solaris software. The 
Solaris installation program guides you step-by-step through identifying 
your system and installing Solaris software. You're in control all the way! 


© Custom JumpStart (formerly called auto-install)—for the advanced user with 
experience in Bourne shell scripting. By creating profiles and rules files, you 
can set up systems to automatically install Solaris software in different ways 
on different systems. This method requires up-front work before systems 
are turned on, but it’s the most cost-effective way to install Solaris software 
for large, enterprise sites. You can even set up a hands-off installation where 
the user just boots the system and nothing more needs to be done! 


Preparing to Install Solaris 11 


lil 
N 


Methods 


O JumpStart 


@ Interactive 


© Custom 
JumpStart 
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Booting Identifying Your System Installing Solaris 


You interact with the 
Solaris installation program 


to identify your system 


You interact with the 
Solaris installation 
program to install Solaris 
software 


You interact with the Solaris 
installation program to 


MOU PCOtSy stem identify your system _ 


You interact with the Solaris 
installation program to 
identify your system 


You boot system 


9 Choose a task map and complete required tasks. 


Choose the task map from the following pages that matches the method you’ve 
chosen for installing Solaris software: JumpStart, interactive, or custom 
JumpStart. The task maps guide you through all the tasks you need to 
complete before turning on, booting, and installing Solaris software on a 
system. 
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Task Map: JumpStart Installations 


Activity Description 


ana wee sree petra canes aees ee ses 
work installation : 


software 


N 
lI 


For Instructions, Go To 


a - reas = leo 


ers for Network Instal- 

lation of a Standalone, 

Server, or Dataless Cli- 
ent’ 


and Installing Solaris: 
JumpStart” 


Figure 2-2. Task Map for JumpStart Installations 


Preparing to Install Solaris 


13 


Z 


Task Map: Interactive Installations 


Activity 


Gather information 


Save files from 
SunsOS 4.x systems 


Prepare system for 
upgrade 


Install Solaris 
software 
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Description 


Optional. 


_ The upgrade option is not available for SunOS 4.x 


| systems. Backup your system and follow other special 
_ procedures. 


{ 


Lenco minteenencerinnnenandetenenncnnee Neer ediny tetera NN ceeneesrnniwenertFbbveeee FEC R NFER MERE Re EEE REEL HLCM ES HONENEEE MODELLER INSEL LEE RIMM HCN MEO ECLE NS CNIECOE EE ODEN AONE CON PEOOCSEEMMCEL ENC MAENERC ENESCO EEO 


i 
i ‘ ‘ , 
_ Perform tasks such as backing up files and preserving 
_ local modifications. 


| Set up systems (standalone, OS server, or dataless 
client) for network installations. 
| 
| 


: 
} 
| 
| 
| 
_ Boot and install Solaris software. 
i 
| 


Figure 2-3 Task Map for Interactive Installations 
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For Instructions, 
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sheets for the So- 
laris Installation 


Program” - | 


a. 
2.x Transition Guide 


sec eiredenweniomienson tibecomeetedicees swaocotemernravverenereneninenwennionne es fea ennr nina Men! reve nnounerenenenmeevenneentenmner sicciibrrarinenteyvenvanevenecenersarenscinwenndnniiiesninsscaionaneossiceceiesied 


Chapter , page 113 
“Preparing a | 

System for | | 
Upgrade” | | 


page17 
“Preparing to - 
Install Solaris Over 
a Network” 


Chapter 8, 
“Booting and 
Installing Solaris: 
Interactive” 


ony Raaaaialas oT a 
“Booting and 


Installing Solaris: 


| page 125 
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Task Map: Custom JumpStart Installation 


Activity 


Save files from 
SunOS 4.x system 


Prepare system for 


upgrade 


Set up system for 
custom JumpStart 


install Solaris 


Software 


Description 


eoeas cacan A eee 


| The upgrade option is not available for SunOS 4.x 
_ systems. Backup your system and follow other 
special procedures. 


For Instructions, Go To 


Solaris Lx to Solaris 2.x 
Transition Guide 


N 
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_ Upgrade option only 
_ Perform tasks such as backing up files and 
_ preserving local modifications. 


_* Create a JumpStart directory 

_¢ Enable clients to access the JumpStart directory 
_© Create profiles 

© Create a rules file 

_¢ Use check to validate the rules file 


Chapter , “Preparing a 
System for Upgrade” 


Custom JumpStart 
Installations” 


page 113 


_From another system on the network 
_ Set up systems (standalone, OS server, or 
_dataless client) for network installations. 


Chapter 3, “Preparing 
to Install Solaris Over a 
Network” 


Chapter 9, “Booting 
and Installing Solaris: 
Custom JumpStart” 


page 17 


page 131 


: From local CD-ROM 
| Boot and install Solaris software. 


Chapter 9, “Booting 
and Installing Solaris: 


Figure 2-4 Task Map for Custom JumpStart Installations 


Preparing to Install Solaris 


page 131 


Custom JumpStart’ 
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How to Set Up Servers for Network Installation of a Standalone, Server, page 31 
or Dataless Client 
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| How to Preconfigure Default Locale Using NIS+ page 43 | 


About Installing Solaris Over a Network 


A typical way to install Solaris software is to use the installation program to 
copy the Solaris CD shipped with your system. However, it is uncommon at 
most sites for every system to have its own local CD-ROM drive. When a 
system does not have a local CD-ROM drive, you can perform a network 
installation. Network installation means that you install software over the 
network—from a system with a CD-ROM drive to a system without a 
CD-ROM drive. 
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Note — Instructions in this chapter are valid for either an x86 or SPARC server 
being used for network installations. An x86 server can provide the Solaris CD 
image for SPARC systems, and a SPARC server can provide the Solaris CD 
image for x86 systems. 


Servers Required for Network Installation 


As shown in Figure 3-1, systems that install Solaris software over the network 
require: 


° Install server — A networked system with the CD-ROM drive that provides 
installation services for other systems. 


° Name server — A system that manages a distributed network database (such 
as NIS or NIS+) containing information about users and other systems on 
the network. | 


Note — The install server and name server may be the same or separate 
systems. | 


° Boot server — A system that boots the system to be installed over the 
network. A boot server and install server are typically the same system. 
However, if the system to be installed is on a different subnet than the install 
server, a boot server is required on that subnet. 


Dataless clients also require: 


° OS server — A system that provides Solaris operating environment software 
including services and/or file systems. For dataless clients, OS servers 
provide the /usr file system. 
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Boot Server Standalone Standalone Diskless Dataless 


Subnet 


Standalone Standalone Diskless Dataless 


Figure 3-1 Network Installation Servers 
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Requirements for Hands-Off Network Installation 


To set up your site to install Solaris software on systems over the network with 
no user intervention, you must: 


° Use the custom JumpStart installation method. (See Chapter 4, eke 
Custom JumpStart Installations.”) 


® Make sure all systems are properly configured in the name service. 
(Procedures in this chapter include information on how to add systems to 
the name service.) 


° Preconfigure network information, such as the date, time, geographic 
region, site subnet mask, and language. By using the Solstice Host Manager 
to set up a server for network installations, you automatically preconfigure 
network information. This eliminates many prompts that are otherwise 
necessary to identify the system during an installation. 
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Table 3-1 shows programs available for setting up network installations. 


Table 3-1 Network Installation Commands 


Program 


setup_install_server 


Host Manager 


mount 


uname -i 


reset 


banner 


Description 


A script that copies all or part of the Solaris CD onto a 
server's local disk. This enables you to perform 
network installations from the install server’s disk 
instead of its CD-ROM drive. (Installing from the 
install server’s disk is faster than installing from the 
server’s CD-ROM drive.) See the 
setup_install_server (1m) man page for more 
information. 


A graphical user interface that is available from within 
the Solstice AdminSuite (solstice). You can use 
Host Manager to specify naming services, system’s IP 
and Ethernet addresses, and other information to be 
used for installations across a network. 


A command that shows mounted file systems, 
including the Solaris CD file system. See the 
mount (1M) page for more information. 


A command for determining a system’s platform 
name (for example, SUNW,SPARCstation-5,). This 
information is sometimes required during installation. 
See the uname (1) man page for more information. 


A command for resetting the terminal settings and 
display. It is sometimes useful to use reset before 
booting. Or, if you boot and see a series of error 
messages about I/O interrupts, press the L1 or STOP 
and A keys at the same time, and then enter reset at 
the ok or > PROM prompt. 


A command for displaying system information, such 
as model name, Ethernet address, or memory 
installed. Available only from the ok or > PROM 
prompt. 


Preparing to Install Solaris Over a Network 21 


3 


Creating an Install Server 
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If you are installing systems over the network, you must have an install 
server—a system with a CD-ROM drive or with Solaris software copied to its 
local disk. This system will provide the installation services for systems on the 
network that do not have a local CD-ROM drive. 


You can create an install server to install the following system types: 
° OS server 
¢ Standalone system 


® Dataless client 


This section describes how to: 
® Set up a new system to be an install server. 


® Create an install server by mounting the Solaris CD or by copying the 
Solaris CD to the install server’s local disk. 


Note — If you intend to do frequent installations over the network, you should 
copy the Solaris CD image from the Solaris CD to the install server’s local disk. 
Network installations from the install server’s local disk are faster than from 
its CD-ROM drive. Copying Solaris CD image to the install server’s disk also 
frees the CD-ROM drive for other uses. 


* Create a separate boot server (required only if systems are not on same 
subnet as the install server). 


Vv How fo Set Up a New System to be an Install Server 


Overview — Setting up a new system to be an install server involves: 
° Installing the system hardware, including a CD-ROM drive 

* Connecting the system to a network 

° Installing Solaris software 

Follow this procedure to create an install server 


1. Install the system hardware, including a CD-ROM drive. 
Follow the hardware documentation for detailed information. 
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Complete 


Qo 
HHI 


2. Connect the system to the network. 
Follow the hardware documentation for detailed information. 


3. Install Solaris software. 
During an interactive installation, you are prompted to select a name 
service. Follow the guidelines in the next table: 


Is a Name Service Then ... 
Running at Your Site ... 


Yes Select NIS or NIS+, whichever your site uses, when 
prompted for a name service. After the Solaris 
software is installed, go to How to Create an Install 
Server on page 24. 


No Select None when prompted for a name service. 
After the Solaris software is installed, go to Step 4. 


4. If you want this system to be a name server, set up a name service after 
you have installed the Solaris software. For detailed information, see the 
NIS+ and DNS Setup and Configuration Guide. 


The system is now set up so that you can make it an install server. Next, you 
must make a Solaris CD image available to other systems. To continue, go to 
the How to Create an Install Server on page 24. 
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Vv How to Create an Install Server 


Overview — Creating an install server involves: 
® Choosing a system with a CD-ROM drive to be the install server 
* Mounting the Solaris CD 


® Using the setup_install_server command to copy the Solaris CD to the 
install server’s local disk (optional, but recommended) 


Follow this procedure to create an install server. 


1. On the system that is going to be the install server, log in and become 
root. 
This system must have a CD-ROM drive. 


2. Insert the Solaris CD into the CD-ROM drive. 


3. Mount the Solaris CD (if needed) and change the directory to the 
mounted CD: | 


If the Install Then ... 
Server Is ... 


Running Volume cd /cdrom/cdrom0/s0 
Management or | 
cd /cdrom/cdrom0/s2 


Note: Volume Management is running if the /vol directory 
on the system contains files. Systems running Solaris 2.0 or 
2.1 do not have Volume Management. 


Not running 1) mount -F hsfs -o ro /dev/dsk/cO0t6d0s0 /cdrom ~ 
Volume or 
Management mount -F hsfs -o ro /dev/dsk/cOté6d0p0 /cdrom 


Vcd /edrom 


wef Ne NA 


4. Determine your next step based on whether or not you want to copy the 
Solaris CD to the install server’s local disk: 


If You ... Then ... 


Want to copy the Solaris CD Go to Step 5. 
Do not want to copy the Solaris CD Go to Step 7. 
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5. Use the setup_install_server command to copy the contents of the 
Solaris CD to the install server’s local disk. 


# ./setup_install_server install_dir_path 


In this command, 


install_dir_path Specifies the directory where the Solaris CD image 
will be copied. You can substitute any directory 


path. 


For example, the following command copies the Solaris CD image from the 
Solaris CD to the /export/install directory on the local disk: 


./setup_install_server /export/install 


Note — The setup_install_server command will indicate if you do not 
have enough disk space to copy the Solaris CD image from the Solaris CD. Use 
the df -k1 command to determine available disk space. 


6. Type cd install_dir_path and press Return. 
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Task 


Complete 


7. Determine your next step based on whether or not the install server is on 
the same subnet as the system to be installed. 


If Install Server Is ... Then ... 


On same subnet as the Go to Task Complete on page 26. 
system to be installed 


Not on the same subnet Follow the procedure How to Create a Boot Server on a 

as the system to be Subnet on page 27. You must complete this procedure 

installed when the install server is not on the same subnet as the 
system to be installed. After completing that procedure, 
go to Task Complete on page 26. 


The install server is now created. Next, you must add information to the install 
server’s configuration files so it recognizes the systems to be installed. To 
continue, go to How to Set Up Servers for Network Installation of a 
Standalone, Server, or Dataless Client on page 31. 
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Vv How to Create a Boot Server on a Subnet 


You can install Solaris software over the network from any install server on the 
network. However, a system that will use an install server on another subnet 
requires a separate boot server on its own subnet. 


Overview — Creating a boot server involves: 


Choosing a system with a CD-ROM drive to be the boot server for the 
subnet 


Mounting the Solaris CD 


Using the setup_install_server -b command to copy required 
platform information from the Solaris CD to the local disk 


Follow this procedure to set up a boot server on a subnet. 


1. 


On the system that will be the boot server for the subnet, log in and 
become root. 

This system must have a CD-ROM drive or an NFS mount of a Solaris CD 
image. The system must also be in the NIS or NIS+ name service. (If your 
site doesn’t use the NIS or NIS+ name service, you must distribute 
information about this system by following your site’s policies.) 


. Determine your next step based on whether the boot server uses a local 


CD-ROM drive or an NFS mount of a Solaris CD image. 


If the Boot Server Uses... Then... 


Local CD-ROM drive 1) Insert the Solaris CD into the CD-ROM drive. 
2) Go to Step 3. 

NFS mount of a Solaris 1) mount -F nfs -o ro server_name:path /mnt 

CD image where server_name : path is the host name and 
absolute path to the Solaris CD image. 
2) cd /mnt 


3) Go to Step 4. 
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3. Mount the Solaris CD (if needed) and change the directory to the 
mounted CD: | | 


If the Boot Server Then... 
Is ... 


Running Volume cd /cdrom/cdrom0/s0 
Management or 
cd /cdrom/cdrom0/s2 


Note: Volume Management is running if the /vol directory 
on the system contains files. Systems running Solaris 2.0 or 
2.1 do not have Volume Management. 


Not running 1) mount -F hsfs -o ro /dev/dsk/c0t6éd0s0 /cdrom 
Volume or 
Management mount -F hsfs -o ro /dev/dsk/c0t6d0p0 /cdrom 


2)cd /cdrom 
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4. Use the setup_install_server command to set up the boot server for 
the subnet. 
The setup_install_server command copies all supported platform 
information to the local disk. 


# ./setup_install_server -b boot_dir_path 


In this command, 


=e Specifies that the system will be set up as a boot 
server. 
boot_dir_path Specifies the directory where the platform 


information will be copied. You can substitute any 
directory path. 


For example, the following command copies platform information necessary 
for booting supported platforms over the network: 


./setup_install_server -b /export/install 


Note — The setup_install_server command will indicate if you do not 
have enough disk space to copy the platform dependent information. Use the 
df -kl command to determine available disk space. 


The boot server is now set up to boot supported systems on a subnet. To 
Task | continue, go to How to Set Up Servers for Network Installation of a 
Standalone, Server, or Dataless Client on page 31. 


Complete 
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Setting Up Servers for Network Installation 
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This section describes how to set up appropriate servers necessary to install a 
system over a network. The next table shows servers required for each system 
type you want to install. | 


If System Type You Are Installing Is?... Then You Need This Server Support ... 


Standalone system Install server 
OS server Install server 
Dataless client Install server and OS server 


1. Systems also require a boot server if they are on a different subnet than the install server. 


Note — When you install a server, you must allocate disk space required for the 


clients that server will support. Then, after the server is installed, you must use 
the Solstice Host Manager and add the platform support required by those 
clients. 
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Vv How to Set Up Servers for Network Installation of a Standalone, Server, 
or Dataless Client 


Once you have an install server set up, you are ready to use it to install Solaris 
software on other systems on the network. Before you can actually do that, 
however, you need to provide some basic system information about the 
systems that you are going to install. You do this by using the Solstice Host 
Manager. 


Note — SunSoft plans to remove support for the dataless client system type 
after Solaris 2.5. You can set up this system type now, but in future releases you 
will need to change it to a different type (standalone, OS server, diskless client, 
or AutoClient system.) 


The procedure to add system information about standalone systems, servers, 
and dataless clients to the install server can all be accomplished using the 
Solstice Host Manager. You simply fill out a form and apply the information 
you provide, and the Solstice Host Manager updates the appropriate files and 
name server maps or tables. 


Overview — This procedure involves: 


° Using the Solstice Host Manager to update the name service, to add 
information about the standalone, server, or dataless client to the install 
server’s configuration files, and, if necessary, to set up a file server 


Follow this procedure to set up the install server to install a standalone system, 
a server, or a dataless client on the network. 


1. On the install server, log in as a user in the administration group 


(group 14). 


Caution — If your system is part of the NIS+ name service, you must run the 
Solstice AdminSuite" while logged in as a user in the NIS+ admin group. 
Otherwise, you will not have permission to update configuration information 
on the name server. 


2. Start the Solstice AdminSuite with the following command. 


S /usr/bin/solstice & 
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3. After the Solstice AdminSuite main window appears, click on the Host 
Manager icon. 


Note — If your site uses the Domain Name Service (DNS), you will have to 
modify the /etc/nsswitch.conf file and create the /etc/resolv.conf file 
manually. For detailed information, see the NIS+ and FNS Administration Guide. 


4, On the Host Manager: Select Naming Service screen, select a naming 


service and click on the Apply button. See the sample Naming Service 
screen below. 


If the Name Service Is... Then Select ... 


NIS+ NIS+. Host Manager will update the NIS+ tables. 
NIS NIS. Host Manager will update the NIS maps. 
None | None. Host Manager will store the information you 


provide in the /etc files. This will provide enough 
information for systems to boot, and to install Solaris 
software over the network. 


Host Manager: Select Naming Service 


Naming Service: 


5. On the Host Manager main window, choose Add... from the Edit menu. 
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6. Determine your next step based on what kind of system you want to 


install. 


System to Be Installed Is ... 
Standalone system 
OS server 


Dataless client 
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Go to Step 7. 
Go to Step 10. 
Go to Step 13. 
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7. On the Host Manager: Add Host screen, complete all fields and click on 
the OK or Apply button. 


Solstice Host Manager: Add | 


IP Address: 


Ethemet Address: 


Type - Select standalone. system Type: standalone c | 
Timezone Region: United States =“ | 


Install Server - If enabling remote Timezone: Mountain = <3 | | 
install for a network installation, 7 Remote Install - Select if setting 
specify the install server and set Remote Install: ____up a network installation. The 
the path to the location of the install server should have been 


Solaris CD image.—— Install Server: pluto a | set up already. 


Boot Server - If the install client is {38 Fizakenes- 


on a different subnet than the 


install server, specify the boot Root & 
server that resides on the install perepneene. oe 


client’s subnet. 


Profile Server - If using custom——— Profile Server: 


JumpStart installations, specify 
the system with the custom 
Jumpstart profiles on it. 


8. On the Host Manager main window, choose Save Changes from the File 
menu. 


9. Go to Task Complete on page 37. 
Step 10 through Step 13 are only required if you are adding an OS server or 
dataless client. 
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10. On the Host Manager: Add Host screen, complete all fields and click on 
the OK or Apply button. 


Solstice Host Manager: Add 


IP Address: 
Ethernet Address: 


Type - Select OS server. : system Type: 


Install Server - If enabling remote Timezone: 


install for a network installation, Remote Install - Select if setting 
specify the install server and set Remote Install: [£ Enable Remote Install up a network installation. The 
the path to the location of the install server should have been 


Solaris CD image.—— Install Server: pluto ca | set up already. 


Boot Server - If the install client is OS Release: 
on a different subnet than the ; 
install server, specify the boot 
server that resides on the install- Boot Server: 


client’s subnet. 


Profile Server - If using custom— Profile Server: 


JumpStart installations, specify 
the system with the custom 
Jumpstart profiles on it. 


11. On the Host Manager main window, choose Save Changes from the File 
menu. 


12. Go to Task Complete on page 37. 
Step 13 is required only for adding dataless clients for network installation. 
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13. On the Host Manager: Add Host screen, complete all fields and click on 
the OK or Apply button. 


Salstice Host Manager: Add 


IP Address: 
Ethernet Address: 


oystem Type: dataless & | 


Timezone Region: United States I 


Timezone: Mountain << 
File Server - Specify the system 


that you want to provide /usr 
‘file systems for the dataless 
client. 


OS Release - Select the OS | File Server: pluto 
Release you want installed on 
the dataless client. The proper 
OS support must reside on the 
install server. (You set up this 

support by using Host Manager 


after the server has been : 
installed. This is referred to as Install Server: ‘Set Path... 


“adding services.” 2 
Boot Server: none <I 


Profile Server: 


OS Release: i sparc sunde solaris 2.4 &i 


Remote install: 


im) 
a 
e 
0 
o 
= 
5 
5 
= 
a 
a 


14. On the Host Manager main window, choose Save Changes from the File 
menu. 
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The standalone system, OS server, or dataless client is now added for network 
installation. You are now ready to boot and install over the network. To find 
the correct booting and installing procedure in this book, see the appropriate 
chapter for the installation you want to perform: 


Complete |} 


¢ Chapter 7, “Booting and Installing Solaris: JumpStart” 
¢ Chapter 8, “Booting and Installing Solaris: Interactive” 
¢ Chapter 9, “Booting and Installing Solaris: Custom JumpStart” 


Using add_install_client to Set Up Servers for Network Installation 


Install servers running versions of Solaris released prior to Solaris 2.4 software 
may not have access to the Solstice AdminSuite. You can install the Solstice 
products on Solaris 2.3 and 2.4 systems and follow the instructions in How to 
Set Up Servers for Network Installation of a Standalone, Server, or Dataless 
Client on page 31. Alternatively, you can use the add_install_client 
command to set up the install server for network installations, as described in 
the next section. 
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Vv How to Use add_install_client to Set Up Servers for Network 
Installation | 


Use the add_install_client command to add information about the 
system to be installed to the boot server configuration files. 


In this command, 


=¢ Specifies a JumpStart directory for custom 
JumpStart installations. This option and its 
arguments are required only for custom JumpStart 
installations. 


server :jumpstart_dir_path server is the host name of the server on which the 
JumpStart directory is located. jumpstart_dir_path 
is the absolute path of the JumpStart directory. 


-s 7 Specifies the install server. 


install_server : install_dir_path install_server is the host name of the install server. 
install_dir_path is the absolute path name of the 
mounted Solaris CD or the directory that has the 
copy of the Solaris CD image. 


host_name Is the host name of the standalone system or the 
server where Solaris software will be installed 
over the network. (This is not the host name of the 
install server). The host must be in the name 
service for this command to work. 


latform group is the platform group of the system to be installed. 
(For a detailed list of platform groups, See 
Appendix C, “Platform Names and Groups.”) 


For example, the following command copies boot information from Solaris CD 
image on an install server’s local disk in /export/install. 
add_install_client sets up the /tftpboot directory on the local system, 
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which will be the boot server. The system that will be installed is named 
basil, and it is a SPARCstation™ 10. The platform group for a SPARCstation 
10 is sun4m. 


./add_install client -s install_serverl:/export/install basil sun4m 


Task ), The standalone system, server, or dataless client is now added for network 
Complete | installation. You are now ready to boot and install over the network. To find 
the booting and installing procedure in this book, see the appropriate chapter 
for the installation you want to perform: 


¢ Chapter 7, “Booting and Installing Solaris: JumpStart” 
¢ Chapter 8, “Booting and Installing Solaris: Interactive” 
¢ Chapter 9, “Booting and Installing Solaris: Custom JumpStart” 
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Preconfiguring the Default Locale 
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When installing a localized version of Solaris software, you are prompted for 
the locale (the language) you want to use for the duration of the installation 
process. The locale you choose for installing Solaris software is also the default 
locale the installed version of Solaris will provide to the system’s user. | 


You can set up a default locale of your choice. You do this by modifying the 
naming service (NIS or NIS+). After you modify the name service, as described 
in this section, the operating system will use this default locale for users. Also, 
the installation software will use the default locale for all future installations. 


Choose from the following two procedures, depending on whether your site 
uses the NIS or NIS+ name service. | 


Vv How fo Preconfigure Default Locale Using NIS 


Overview — The procedure to preconfigure the default locale at sites using the 
NIS name service involves: 


® Using the vi or text editor to edit files in the /var/yp/Makefile file 
° Creating a locale file in the /etc directory 


° Updating the NIS maps 


Follow these instructions to set up a default locale for the system being 
installed over the network. 
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1. On the name server, log in and become root and edit the 
/var/yp/Makefile file. 
Add the following text after the other * . time entries. 


locale.time: $(DIR)/locale 
-@if [ -£ S$(DIR)/locale ]; then \ 
sed -e "/*#/d" -e s/#.*SS// S$(DIR)/locale \ 
| awk '{for (1 = 2; 1<=NF; 1++) print $Si, $$0}' \ 
| S(MAKEDBM) - S(YPDBDIR)/S$(DOM)/locale.byname; \ 
touch locale.time; \ 
echo "updated locale"; \ 
if { ! $(NOPUSH) ]; then \ 
$(YPPUSH) locale.byname; \ 
echo "pushed locale"; \ 
else \ 


echo "couldn’t find S$(DIR)/locale"; \ 


2. Edit the /var/yp/Makefile file. 
a. Add locale to the line starting with the word all. 


b. Add locale: locale.time ona new line. 


all: passwd group hosts ethers networks rpc services protocols netgroup bootparams aliases \ 


timezone locale 
locale: locale.time 
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3. Create the file /etc/locale and make one entry for each domain. 


domain_name locale 


The entry specifies the default locale for the domain. For example, the 
following line specifies French to be the default locale for the worknet .com 
domain: 


worknet.com fr 


You can also use a host name instead of the domain name to specify the 
default locale for a particular host. For example, the following line specifies 
Korean to be the default locale for system named sherlock: 


sherlock ko 
See the table on page 44 for a list of valid locale values. 


Note — Not all locales are available on all Solaris CDs. The locale you select 
will be used for installation if it is present on the Solaris CD. 


4. Make the maps. 


# cd /var/yp; make 


Systems in the name service are now set up to use the default locale. The 
default language you have specified will be used during the installation and 
will also be the language provided to system users. 


Task 
Complete 
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Vv How fo Preconfigure Default Locale Using NIS+ 


Overview — The procedure to preconfigure the default locale at sites using the 
NIS+ name service involves: 


° Using the nistbladm command to create a locale table and add 
information to it 


° Updating the NIS+ tables 


Note — The installation software is not translated to the Asian locales, so this 
procedure will not work for any of the Asian locales. 


Follow these instructions to set up a default locale for a system being installed 
over the network. (This procedure assumes the NIS+ domain is set up. Setting 
up the NIS+ domain is documented in the NIS+ and FNS Administration Guide.) 


1. Log in to a name server as root or as a user in the NIS+ admin group. 


2. Use the following nistbladm command to create the locale table. 


# nistbladm -D access=og=rmcd,nw=r -c locale _tbl 
name=SI,nogw= locale=,nogw= comment=,nogw= 


locale.org_dir.'nisdefaults -d' 
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3. Add an entry to the locale.org_dir table by typing the following 
nistbladm command. 


# nistbladm -a name=domain_name localeszlocale comment=comment 


locale.org_ dir. ‘nisdefaults -d' 


In this command, 


domain_name Is either the domain name or a specific host name 
for which you want to preconfigure a default 
locale. 

locale Is the locale you want to use to install the system 


and the locale you want to come up on users’ 
systems. The following table shows valid values 


for locale. 
Language Valid locale Values 
Chinese | zh 
English (Solaris default) C 
French te 
German de 
Italian it 
Japanese ja 
Korean ko 
Latin American | es 
Swedish | SV 
Taiwanese zh_TW 
comment Is the comment field. Use double quotation marks 
to begin and end comments that are longer than 
one word. 


Note — Not all locales are available on all Solaris CDs. The locale you select 
will be used for installation if it is present on the Solaris CD. 
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Systems in the name service are now set up to use the default locale. The 
default language you have specified will be used during the installation and 
will also be the language provided to system users. 
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Definition: Custom JumpStart Installation 


A custom JumpStart installation is a type of installation in which the Solaris 
software is automatically installed on a system based on a user-defined profile. 
You can create customized profiles for different types of users. 


Note — Appendix D, “Sample Custom JumpStart Installation” provides an 
example of how a fictitious site is prepared for custom JumpStart installations. 
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Note — Instructions in this chapter are valid for either an x86 or SPARC server 
that is being used for custom JumpStart installations. An x86 server can 
provide custom JumpStart files for SPARC systems, and a SPARC system can 
provide custom JumpStart files for x86 systems. 


Reasons to Choose a Custom JumpStart Installation 
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You should choose custom JumpStart installations when you have to install 
Solaris software on: ; 


° Many systems. 
° Particular groups of systems. 


For example, the following scenario would be ideal for performing custom 
JumpStart installations: 


° You need to install the Solaris software on 100 new systems. 


° The engineering group owns 70 out of the 100 new systems, and its systems 
must be installed as standalone systems with the developer software group. 


¢ The marketing group owns 30 out of the 100 new systems, and its systems 
must be installed as standalone clients with the end user software group. 


These installations would be time-consuming and tedious if you chose to 
perform an interactive installation on each system. 
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Tasks to Prepare for Custom JumpStart Installations 


Task 


Creating a JumpStart 
directory on a diskette or 
on a server 


Enabling all clients to 
access the JumpStart 
directory 


Creating profiles 


Creating a rules file 


Using check to validate 
the rules file 


Table 4-1 shows the tasks that are required to prepare for custom JumpStart 
installations. 


Table 4-1 Tasks to Prepare for Custom JumpStart Installations 


rules 


le 


Es 


rules.ok File 


Description 


You must create a JumpStart directory to hold the custom 
JumpStart files. If you are going to use a diskette for 
custom JumpStart installations, see “Creating a JumpStart 
Directory on a Diskette” on page 53. If you are going to 
use a server for custom JumpStart installations, see 
“Creating a JumpStart Directory on a Server” on page 62. 


When you use a server to provide the JumpStart directory, 
you can enable all clients to access the JumpStart directory. 
See “Enabling All Systems to Access the JumpStart 
Directory” on page 65 for detailed information. 


A profile is a text file used as a template by the custom 
JumpStart installation software. It defines how to install 
the Solaris software on a system (for example, initial or 
upgrade installation option, system type, disk partitioning, 
software group), and it is named in the rules file. See 


“Creating a Profile” on page 67 for detailed information. 


The rules file is a text file used to create the rules.ok 
file. The rules file is a look-up table consisting of one or 
more rules that define matches between system attributes 
and profiles. See “Creating the rules File” on page 82 for 
detailed information. 


The rules.ok file is a generated version of the rules file, 
and it is required by the custom JumpStart installation 
software to match a system to a profile. You must use the 
check script to create the rules.ok file. See “Using check 
to Validate the rules File” on page 93 for detailed 
information. 
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What Happens During a Custom JumpStart Installation 


Figure 4-1 describes what happens after you boot a system to perform a 
custom JumpStart installation. 


BEGIN 


Does the system find 


Does the system find a dis- Yes The system mounts 


kette in the system’s diskette the diskette. a rules.ok file on the Yes 
drive? diskette? 
No 
Does the system find a Does the system match any Yes 
rules.ok file on a designated rules in the rules.ok file? 
server? | 
No 


END 


The system proceeds with a 
custom JumpStart installa- 


END 
The system proceeds with 


an interactive installation. cians 
tion. The profile specified in 


the matched rule is used to 
install the system. 


Figure 4-1 What Happens During a Custom JumpStart Installation 
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Figure 4-2 is an example of how a custom JumpStart installation works on a 
standalone, non-networked system using the system’s diskette drive. 


Pete's System 


The Solaris installation pro- 
gram uses the selected profile 
to automatically install the 
Solaris software on Pete’s sys- 


tem. 


After the system boots, 
the Solaris installation 
program finds a rules.ok 
file on the diskette in the 
system’s diskette drive. 


gees 


JumpStart Directory 


Engineering 
Group’s 
Profile 


The Solaris installation pro- 
gram finds a matching rule 
for Pete’s system. 


Marketing 
Group’s 


Profile 


7 Pete’s 
The matched rule specifies a Profile 


profile to use for installing 
Solaris on Pete’s system. 


Figure 4-2. How a Custom JumpStart Installation Works: Non-Networked Example 
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Figure 4-3 is an example of how a custom JumpStart installation works for 
multiple systems on a network where different profiles are accessed from a 


single server. 


@ After a system boots, the 
Solaris installation pro- 
gram finds a rules.ok file 
on designated server. - 


@ Solaris installation pro- 


gram finds a matching rule : cole 
for the specific system. | — cael 


© The matched rule speci- 
fies a profile to use for 
installing the Solaris soft- 
ware on a that system. 


Pete’s System 


——— 
© The Solaris installation program 
uses the selected profile to auto- 


matically install the Solaris soft- 
ware on the system. 


Figure 4-3 How a Custom JumpStart Installation Works: Networked Example 
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Creating a JumpStart Directory on a Diskette 


You should use a diskette for a custom JumpStart installation if the system: 


® Has a diskette drive 
® Has a local CD-ROM drive 
® Is not connected to a network 


When you use a diskette for custom JumpStart installations, the JumpStart 
directory must be the root directory on the diskette that contains all the 
essential custom JumpStart installation files (for example, the rules file, 
rules.ok file, and profiles). The JumpStart directory should be owned by root 
and have permissions equal to 755. 


The diskette requirements for the JumpStart directory are different for x86 and 
SPARC systems. So, the following pages describe how to create a JumpStart 
directory on a diskette for an x86 system and for a SPARC system. 


Vv How fo Create a JumpStart Directory on a Diskette for x86 Systems 


Overview — The procedure to create a JumpStart directory on a diskette for x86 
systems involves: 


¢ Making a copy of the Solaris boot diskette (the copied Solaris boot diskette 
has a PCFS file system) | 


° Copying sample custom JumpStart installation files into the diskette’s root 
directory 


Follow this procedure to create a JumpStart directory on a diskette for x86 
systems. 


1. Log in as root on an x86 or SPARC system that has a diskette drive and a 
CD-ROM drive. 


2. Insert the Solaris boot diskette into the diskette drive. 
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3. Choose the appropriate steps, depending on whether or not the system is 
running Volume Management: 


If the System Is ... Then ... 
Running Volume | Go to Step 4. 
Management 


Note: Volume Management is running if the /vol 
directory on the system contains files. Systems running 
Solaris 2.0 or 2.1 do not have Volume Management. 


Not running Volume Go to Step 12. 
Management 


4. Make sure Volume Management knows about the diskette: 


# volcheck 


5. Copy the Solaris boot diskette image to the system’s hard disk: 


# dd if=/vol/dev/aliases/floppy0 of=boot_image 


In this command, 


boot_image Is the file name where the Solaris boot diskette 
image is copied. You can specify an absolute path 
name. | 


For example, the following command would copy a Solaris boot diskette to 


the boot_save file. 


dd if=/vol/dev/aliases/floppy0 of=boot_save 
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6. Eject the Solaris boot diskette: 


Note — The following command is not required for x86 systems; you must 
manually eject the diskette on an x86 system. 


# eject floppy 


7. Insert a blank diskette into the diskette drive. 


8. Make sure Volume Management knows about the diskette: 


# volcheck 


9. Format the diskette: 


{ Caution — This step will overwrite any data on the diskette. 


# fdformat -d -U 


10. Copy the Solaris boot diskette image from the system’s hard disk to the 
formatted diskette: 


# dd if=boot_image of=/vol/dev/aliases/floppy0 


The boot_image variable should be the same as in Step 5. 


11. Go to Step 17. 
Step 12 through Step 16 are used if the system is not running Volume 
Management. 


Ol 
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12. Copy the Solaris boot diskette image to the system’s hard disk: 


# dd if=/dev/rdiskette of=boot_image 


In this command, 


boot_image Is the file name where the Solaris boot diskette 
image is copied. You can specify an absolute path 
name. 


For example, the following command would copy a Solaris boot diskette to 
the boot_save file. 


dd if=/dev/rdiskette of=boot_save 


13. Eject the Solaris boot diskette: 


Note — The following command is not required for x86 systems; you must 
manually eject the diskette on an x86 system. 


# eject fd 


14. Insert a blank diskette into the diskette drive. 


15. Format the diskette: 


" Caution — This step will overwrite any data on the diskette. 


# fdformat -d 
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16. Copy the Solaris boot diskette image from the system’s hard disk to the 
formatted diskette: 


# dd if=boot_image of=/dev/rdiskette 


The boot_image variable should be the same as in Step 12. 


17. Mount the diskette: 


If the System Is ... Then ... 
Running Volume 1) Eject the copied Solaris boot diskette. 
Management 2) Insert the copied Solaris boot diskette back into the 


diskette drive. 

3) Make sure Volume Management knows about the 
diskette: 

volcheck 


Not running Volume mount -F pcfs /dev/diskette jump_dir_path 
Management 
Note: jump_dir_path is the absolute directory path where 
the diskette is mounted. 


18. Determine your next step based on where the Solaris CD is located. 


If You Want to Use The... Then... 


Solaris CD in the local 1) Insert the Solaris CD into the CD-ROM drive. 
CD-ROM drive 2) Go to Step 19. 


Solaris CD image on local 1) Change the directory to the Solaris CD image on the 
disk local disk. For example: | 
cd /export/install 
2) Go to Step 20. 
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Task 
Complete 


19. Mount the Solaris CD (if needed) and change the directory to the 
mounted CD: 


If the System Is ... Then ... 
Running Volume cd /cdrom/cdrom0/s0 
Management or 


cd. jscdrom/carom0/s2 


Notrunning Volume I)mount -F hsfs -o ro /dev/dsk/c0t6d0s0 /cdrom 
Management _ or 
mount -F hsfs -o ro /dev/dsk/c0Ot6d0p0 /cdrom 
2)cd /cdrom 


20. Copy the JumpStart installation files from the auto_install_sample 
directory on the Solaris CD into the JumpStart directory (root directory) of 
the diskette: 


If the System Is... Then... 


Running Volume cp -r auto_install_sample/* /floppy/floppy0/. 
Management 


Not running cp -r auto_install_sample/* jumpstart_dir_path 
Volume 
Management Note: jump_dir_path is the absolute directory path where the 


diskette is mounted. 


Caution — File names on PCFS file systems can be only 11 characters long (an 
8-character file name and a 3-character extension). When copying JumpStart 
installation files to a diskette for x86 systems, be aware that the file transfer 
may truncate file names. 


Note — The custom JumpStart installation files must be in the root directory of 
the diskette. 


You have completed creating a JumpStart directory on the diskette. To 
continue, see “How to Create a Profile” on page 67. 
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Vv How to Create a JumpStart Directory on a Diskette for SPARC Systems 


Overview — The procedure to create a JumpStart directory on a diskette for 
SPARC systems involves: 


°¢ Formatting a diskette (if needed). 
° Creating a UFS file system on the diskette (if needed). 


* Copying sample custom JumpStart installation files into the diskette’s root 
directory. 


Follow this procedure to create a JumpStart directory on a diskette for SPARC 
Systems. | 


1. Log in as root on a SPARC system that has a diskette drive and a 
CD-ROM drive. 


2. Insert a diskette into the diskette drive. 


3. Choose the appropriate steps, depending on whether or not the system is 
running Volume Management: 


If the System Is... Then... 
Running Volume Go to Step 4. 
Management 


Note: Volume Management is running if the /vol 
directory on the system contains files. Systems running 
Solaris 2.0 or 2.1 do not have Volume Management. 


Not running Go to Step 12. 
Volume 
Management 


4, Make sure Volume Management knows about the diskette: 


| # volcheck : 
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5. If the diskette already has a UFS file system on it, go to Step 16. 
To find out if the diskette has a UFS file system on it, check the 
/etc/mnttab file for an entry similar to this: 


/floppy/unnamed_floppy ufs 


6. Format the diskette: 


{ Caution - This step will overwrite any data on the diskette. 


# fdformat -U 


7. Create a UFS file system on the diskette: 


# newfs /vol/dev/aliases/floppy0 


CO 


. Eject the diskette: 


# eject floppy | 


9. Insert the formatted diskette back into the diskette drive. 


10. Make sure Volume Management knows about the diskette: 


# volcheck 


11. Go to Step 16. ? 
Step 12 through Step 15 are used if the system is not running Volume 
Management. 


12. If the diskette already has a UFS file system on it, go to Step 15. 
If the mount command fails in Step 15, the diskette does not have a UFS file 
system on it. 
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13. Format the diskette: 


Caution — This step will overwrite any data on the diskette. 


# £fdformat /dev/rdiskette 


14. Create a file system on the diskette: 


# newfs /dev/rdiskette 


15. Mount the diskette: 


# mount -F ufs /dev/diskette jumpstart_dir_path 


In this command, 


jumpstart_dir_path Is the absolute directory path where the diskette is 
mounted. 


For example, the following command would mount a SPARC diskette on the 
/mnt directory: 


mount -F ufs /dev/rdiskette /mnt 
Note — If the mount command fails, go back to Step 13 to format the diskette. 
16. Determine your next step based on where the Solaris CD is located. 


If You Want to Use The... Then... 


| Solaris CD in the local 1) Insert the Solaris CD into the CD-ROM drive. 
CD-ROM drive 2) Go to Step 17. 


Solaris CD image on the —_1) Change the directory to the Solaris CD image on the 
local disk — local disk. For example: 
| ‘cd /export/install 

2) Go to Step 18. 


Preparing Custom JumpStart Installations 61 


HH 
HSN 


17. Mount the Solaris CD (if needed) and change the directory to the 
mounted CD: 


If the System Is ... Then ... 
Running Volume cd /cdrom/cdrom0/s0 
Management or 


ed /cdrom/cdrom0/s2 


Not running Volume 1)mount -F hsfs -o ro /dev/dsk/c0t6d0s0 /cdrom 
Management or | 
mount -F hsfs -o ro /dev/dsk/cOt6d0p0 /cdrom 
2)cd /cdrom | 


18. Copy the custom JumpStart installation files from the 
auto_install_sample directory on the Solaris CD into the JumpStart 
directory (root directory) of the diskette: 


If the System Is ... Then ... 

Running Volume cp -r auto_install_sample/* /floppy/floppy0/. 
Management 

Not running Volume cp -r auto_install_sample/* jumpstart_dir_path 
Management 


Note: jump_dir_path is the absolute directory path where the 
diskette is mounted. | 


Note — The custom JumpStart installation files must be in the root directory of 
the diskette. 


You have completed creating a JumpStart directory on the diskette. To 
continue, see “How to Create a Profile” on page 67. 


pStart Directory on a Server 


Creating a Ju 


If you want to perform custom JumpStart installations by using a server on the 
network, you must create a JumpStart directory on the server. When you use a 
server for custom JumpStart installations, the JumpStart directory is a directory 
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on the server that contains all the essential custom JumpStart files (for 
example, the rules file, rules. ok file, and profiles). The JumpStart directory 
should be owned by root and have permissions equal to 755. 


Vv How fo Create a JumpStart Directory on a Server 


Overview — The procedure to create a JumpStart directory on a server involves: 
* Creating a directory on the server 
° Editing the /etc/dfs/dfstab file 


* Copying sample custom JumpStart installation files into the directory on the 
server 


Follow this procedure to create a JumpStart directory on a server. 


1. Log in as root on the server where you want the JumpStart directory to 
reside. 


2. Create the JumpStart directory anywhere on the server: 


# mkdir jumpstart_dir_path | 


In this command, 


jumpstart_dir_path Is the absolute path of the JumpStart directory. 
For example, the following command would create the directory called 
jumpstart in the root file system: 

mkdir /jumpstart 


3. Edit the /etc/dfs/dfstab file. Add the following entry: 


share -F nfs -o ro,anon=0 jumpstart_dir_path 


For example, the following entry would be correct for the example shown in 
Step 2: 


share -F nfs -o ro,anon=0 /jumpstart 
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4. Type unshareal1 and press Return. 


5. Type shareall and press Return. 


6. Determine your next step based on where the Solaris CD is located. 


If You Want to Use The... Then... 
Solaris CD in the local 1) Insert the Solaris CD into the CD-ROM drive. 


CD-ROM drive 


2) Go to Step 7. 


Solaris CD image on the 1) Change the directory to the Solaris image on the 


local disk 


local disk. For example: 
cd /export/install 
2) Go to Step 8. 


7. Mount the Solaris CD (if needed) and change the directory to the 


mounted CD: 


Then ... 


If the System Is ... 


Running Volume 
Management 


Not running 
Volume 
Management 


ad /cdrom/caromo 7s0 
or 
cd /cdrom/cdrom0/s2 


Note: Volume Management is running if the /vol directory on 
the system contains files. Systems running Solaris 2.0 or 2.1 do 


~ not have Volume Management. 


1)mount -F hsfs -o ro /dev/dsk/c0Ot6d0s0 /cdrom 
or 
mount -F hsfs -o ro /dev/dsk/cOt6d0p0 /cdrom 


2)cd /cdrom 


8. Copy the contents of the auto_install_sample directory from the 
Solaris CD-ROM into the JumpStart directory: 


For example, the following command would copy the 
auto_install_sample directory into the JumpStart directory created in 


Step 2: 
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cp -r auto_install_sample/* /jumpstart 


You have completed creating a JumpStart directory on the server. To continue, 
see “How to Create a Profile” on page 67. 


Task : 
Complete : 


Enabling All Systems to Access the JumpStart Directory 


When you create a JumpStart directory on a server, you must make sure 
systems can access it during a custom JumpStart installation. There are two 
ways to do this: 


° Using the -c option of the add_install_client command every time 
you add a system for network installation. 


or 
¢ Enabling all systems to access the JumpStart directory. 


To save you time when adding systems for network installations, use the 
following procedure to enable all systems to access the JumpStart directory 
from a server. 


Note — The following procedure is not necessary if you are using a diskette for 
the JumpStart directory. 


Vv How to Enable All Systems to Access the JumpStart Directory 


Overview — The procedure to enable all systems to access the JumpStart 
directory from a server involves: 


e Editing the /etc/bootparanms file 


°® Updating the name service (NIS or NIS+) with the information you’ve 
added to the /etc/bootparams file 


Follow this procedure to enable all systems to access the JumpStart directory 
from a server. 


1. On the NIS or NIS+ master server, log in as root. 
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2. Edit the /etc/ bootparams file or create the /etc/bootparams file if it 
does not exist. Add the following entry: | 


In this entry, 


Is a wildcard character specifying all systems. 


server Is the host name of the server where the JumpStart 
directory is located. 


jumpstart_dir_path Is the absolute path of the JumpStart directory. 
For example, the following entry would enable all systems to access the 
/jumpstart directory on the server named sherlock: 


* install_config=sherlock:/jumpstart 
Caution — Using this procedure may produce the following error message 
when booting an install client: 


WARNING: getfile: RPC failed: error 5: (RPC Timed out). 
See page 173 for more details on this error message. 


3. Update the NIS or NIS+ tables (if necessary) with the information you 
added to the /etc/bootparams files. 


If Your Site Uses... Then... 


NIS /var/yp/make 
NIS+ /usr/lib/nis/nispopulate -F -p /etc bootparams 
No name service ‘Go to Task Complete on page 67. 


Task 
Complete 
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All systems can now access the JumpStart directory. You no longer need to use 
the -c option of the add_install_client command when adding systems 
for network installations. 


Creating a Profile 


What Is a Profile 


A profile is a text file used as a template by the custom JumpStart installation 
software. It defines how to install the Solaris software on a system (for 
example, initial or upgrade installation option, system type, disk partitioning, 
software group), and it is named in the rules file. 


A profile consists of one or more profile keywords and their values. Each 
profile keyword is a command that controls one aspect of how the Solaris 
installation program will install the Solaris software on a system. For example, 
the profile keyword and value 


system_type server 
tells the Solaris installation program to install the system as a server. 
Note — If you created the JumpStart directory by using the procedures on | 


page 53 or page 62, example profiles should already be in the JumpStart 
directory. 


Requirements for Profiles 


The following are requirements when creating a profile: 
¢ The install_type profile keyword is required. 


® Only one profile keyword can be on a line. 


Vv How fo Create a Profile 


Overview — The procedure to create a profile involves: 


° Editing a file 
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© Selecting profile keywords and profile values to define how to install the 
Solaris software on a system | 


Follow this procedure to create as many profiles as you need for your site. 


1. Open a file (the profile) and give it a descriptive name. 
You can create a new file or edit one of the sample profiles in the JumpStart 
directory you created. 


The name of a profile should reflect how it will install the Solaris software 
on a system (for example, basic_install, eng_profile, or 
user_profile). 


2. Add profile keywords and profile values to the profile. 
Be aware of these things as you edit the profile: 


Profile Examples on page 69 provides some examples of profiles. 

Table 4-2 on page 72 provides the list of valid profile keywords and 
values. 

You can have as many lines in the profile as necessary to define how to 
install the Solaris software on a system. 

You can add a comment after the pound sign (#) anywhere on a line. If a 
line begins with a #, the entire line is a comment line. If a # is specified in 
the middle of a line, everything after the # is considered a comment. Blank 
lines are also allowed in a profile. 

The profile keywords and their values are case sensitive. 

Profiles should be owned by root and have permissions equal to 644. 


Note — See “Using pfinstall to Test Profiles” on page 104 for detailed 
information about testing profiles. 


This completes the procedure to create a profile. To continue setting up for a 
custom JumpStart installation, see How to Create the rules File on page 83. 
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Profile Examples 


# profile keywords 


install_type 


system_type 


partitioning 
| filesys 
filesys 


filesys 


cluster 
package 
package 
package 
package 
package 
package 
package 


The following profile examples describe how you can use different profile 
keywords and profile values to control how the Solaris software is installed on 
a system. See Table 4-2 on page 72 for the list of profile keywords and profile 
values. 


profile values 


initial_install 
standalone 


default 

any 60 swap # specify size of /swap 

s ref:/usr/share/man - /usr/share/man ro 
s_ref:/usr/openwin/share/man - /usr/openwin/share/man ro,quota 


SUNWCprog 
SUNWman delete 
SUNWolman delete 
SUNWxwman delete 
SUNWoldem add 
SUNWxwdem add 
SUNWoldim add 
SUNWxwdim add 


@ This profile keyword is required in every profile. 


®@ This profile keyword defines that the system will be installed as a 
standalone system. 


© The file system slices are determined by the software to be installed 
(default value); however, the size of swap is set to 60 Mbytes and it is 
installed on any disk (any value). The standard and OpenWindows man 
pages are mounted from the file server, s_ref, on the network. 


© The developer software group (SUNWCprog) is installed on the system. 


® Because the man pages are being mounted remotely, those packages are 
selected not to be installed on the system; however, the packages containing 
the OpenLook and X Windows demo programs and images are selected to 
be installed on the system. 


Preparing Custom J ump Start Installations 69 


70 


# profile keywords profile values 


install_type initial_install 
system_type standalone 


partitioning default 

filesys | cOtd0d0s0 auto / 
filesys cOt3d0si 32 swap 
cluster SUNWCal11 


@ The file system slices are determined by the software to be installed 
(default value). However, the size of root is based on the selected 
software (auto value) and it is installed on cOt0d0s0, and the size of swap is 
set to 32 Mbytes and it is installed on c0t3d0s1. 


@ The entire distribution software group (SUNWCa11) is installed on the 
system. 


# profile keywords profile values 
# 

install_type irre nse kL 
system_type standalone 


fdisk cOt0Od0 0x04 delete 
fdisk c0t0Od0 solaris maxfree 
eluster SUNWCal1 

cluster SUNWCacc delete 


@ All fdisk partitions of type DOSOS16 (04 hexadecimal) are deleted from the 
c0t0d0 disk. 


@ A Solaris fdisk partition is created on the largest contiguous free space on 
the c0t0d0 disk. | | 


® The entire distribution software group (SUNWCa11) is installed on the 
system. 


© The system accounting utilities (SUNWCacc) are selected not to be installed 
on the system. 
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# profile keywords profile values 


install_type 


package SUNWbcp delete 
package SUNWolman add 
package SUNWxwman add 
cluster SUNWCumux add 


locale de 


@ This profile upgrades a system (SPARC only). 


@ The binary compatibility package (SUNWbcp) is selected to be deleted from 
the system or prevented from being installed. 


© This code ensures that the OpenLook and X Windows man pages and the 
universal multiplexor software are selected to be installed if they are not 
installed on the system. (All packages already on the system are 
automatically upgraded.) 


© The German localization packages are selected to be installed on the system. 
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Profile Keyword and Profile Value Descriptions 


Table 4-2 shows the profile keywords and profile values that you can use in a 
profile. | | 


Table 4-2. Profile Keyword and Profile Value Descriptions (1 of 10) 


Profile 
Keyword Profile Values and Description 


client_arch defines that the server will support a different platform group than it uses. If you do not 
specify client_arch, any diskless client must have the same platform group as the server. You must 
specify client_arch once for each platform group. 


Valid values for karch_value are sun4d, sun4c, sun4m, or i86pc. (See Appendix C, “Platform Names and 
Groups” for a detailed list of the platform names of various systems.) 


Restriction: client_arch can be used only when system_type is specified as server. 


client_root defines the amount of root space (root_size in Mbytes) to allocate for each client. If you do 
not specify client_root in a server’s profile, the installation software will automatically allocate 15 
Mbytes of root space per client. The size of the client root area is used in combination with the 
num_clients keyword to determine how much space to reserve for the /export/root file system. 


Restriction: client_root can be used only when system_type is specified as server. 


client_swap defines the amount of swap space (swap_size in Mbytes) to allocate for each diskless 
client. If you do not specify client_swap, 24 Mbytes of swap space is allocated. 


Example: client_swap 32 
The example defines that each diskless client will have a swap space of 32 Mbytes. 


Restriction: client_swap can be used only when system_type is specified as server. 
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Table 4-2 Profile Keyword and Profile Value Descriptions (2 of 10) 


Profile 
Keyword Profile Values and Description 
cluster —s- group_name 
(use for software 
groups) oo. | 
cluster designates what software group to add to the system. The cluster names for the software 
groups are: 
software Group group_name 
Core SUNWCreq 
End user system support SUNWCuser 
Developer system support SUNWCprog 
Entire distribution SUNWCal1 


Entire distribution plus OEM support SUNWCXal1 


You can specify only one software group in a profile, and it must be specified before other cluster and 
package entries. If you do not specify a software group with cluster, the end user software group 
(SUNWCuser) is installed on the system by default. 


cluster designates whether a cluster should be added or deleted from the software group that will be 
installed on the system. add or delete indicates whether the cluster should be added or deleted. If you 
do not specify add or delete, add is set by default. 


cluster_name must be in the form SUNWCname. To view detailed information about clusters and their 
names, start Admintool on an installed system and select Software from the Browse menu. 


For Upgrade: 

e All clusters already on the system are automatically upgraded. 

e If you specify cluster_name add, and cluster_name is not installed on the system, the cluster is mele 

¢ If you specify cluster_name delete, and cluster_name is installed on the system, the package is 
deleted before the upgrade begins. 


t Profile keywords that can be used for upgrading 
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Table 4-2 Profile Keyword and Profile Value Descriptions (3 of 10) 


Profile 
Keyword Profile Values and Description 


dontuse designates a disk that the Solaris installation program should not use when partitioning 
default is specified. You can specify dontuse once for each disk, and disk_name must be specified in 
the form cxtydz or cydz, for example, c0t0d0. 


By default, the Solaris installation program uses all the operational disks on the system. 


Restriction: You cannot specify the dontuse keyword and the usedisk keyword in the same profile. 


fdisk defines how the fdisk partitions are set up on an x86 system (only required for x86 systems), and 

you can specify fdisk more than once. This is what happens by default with fdisk partitions on x86 

systems: 

e All fdisk partitions on the disk are preserved unless you specifically delete them with the fdisk 
keyword (if size is delete or 0). Also, all existing fdisk partitions are deleted when size is all. 

e A Solaris fdisk partition that contains a root file system is always designated as the active partition on 
the disk (an x86 system boots from the active partition by default). 

e If no fdisk keyword is specified in a profile, the following fdisk keyword is specified during the 
installation: | | | 
fdisk all solaris maxfree 

¢ fdisk entries are processed in the order they appear in the profile. 


disk_name - Choose where the fdisk partition will be created or deleted: 

¢ cxtydz or cydz - A specific disk, for example, c0t3d0. 

¢ rootdisk - The disk where the root file system is placed during an installation, which is determined 
by the Solaris installation program (described on page 91). 

e all - All the selected disks. 


type - Choose what type of fdisk partition will be created or deleted on the specified disk: 

¢ solaris - A Solaris fdisk partition (SUNIXOS fdisk type). 

¢ dosprimary - An alias for primary DOS fdisk partitions (not for extended or data DOS fdisk 
partitions). When deleting fdisk partitions (size is delete), dosprimary is an alias for the 
DOSHUGE, DOSOS12, and DOSOS16 fdisk types (they are all deleted). When creating an fdisk 
partition, dosprimary is an alias for the DOSHUGE fdisk partition (a DOSHUGE fdisk partition is 
created). 
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Table 4-2. Profile Keyword and Profile Value Descriptions (4 of 10) 


Profile Values and Description 


5 disk name see size. 


‘ie - eles aia type of fdisk partition will be created or deleted on the specified disk: 


e DDD - A decimal fdisk partition. DDD is a decimal number (valid values are 1 through 255). 
Restriction: This value can be specified only if size is delete. 

¢ OxHH - A hexadecimal fdisk partition. HH is a hexadecimal number (valid values are 01 through FF). 

Restriction: This value can be specified only if size is delete. 


The following table shows the decimal and hexadecimal numbers for some of the fdisk types: 
fdisk typeDDDHH 
DOSOS12101 
PCIXOS 202 
DOSOS16404 
EXTDOS505 
DOSHUGE606 
DOSDATA8656 
OTHEROS9862 
UNIX0S9963 


size - Choose one of the following: 

e DDD - An fdisk partition of size DDD (in Mbytes) is created on the specified disk. DDD must be a 
decimal number and the Solaris installation program automatically rounds the number up to the 
nearest cylinder boundary. If 0 is specified, it is the same as specifying delete. 

e all - An fdisk partition is created on the entire disk (all existing fdisk partitions will be deleted). 
Restriction: This value can be specified only if type is solaris. 

e maxfree - An fdisk partition is created in the largest contiguous free space on the specified disk. If an 
fdisk partition of the specified type already exists on the disk, the existing fdisk partition is used (a 
new fdisk partition is not created on the disk). 

Note: There must be at least one unused fdisk partition on the disk and the disk must have free space, 

or an error will occur. 

Restriction: This value can be specified only if type is solaris or dosprimary. 

° delete - All fdisk partitions of the specified type are deleted on the specified disk. 
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Table 4-2. Profile Keyword and Profile Value Descriptions (5 of 10) 


Profile Values and Description 


This instance of filesys sets up the installed system to automatically mount remote file systems when _ 
it boots. You can specify filesys more than once. 


For Dataless Clients: Profiles for dataless clients (when system_type dataless is specified) must 
include a remote filesys entry for both the /usr file system. The following line is an example of the 
filesys entries that must be used in a profile to install the Solaris software on a dataless client: 
filesys sherlock:/export/exec/Solaris_2.4_ sparc.all/usr - /usr 

server: - The name of the server where the remote file system resides (followed by a colon). 

path - The remote file system’s mount point name, for example, /usr or /export/home. 

server_address - The IP address of the server specified in server:path. If you don’t have a name service 
running on the network, this value can be used to populate the /etc/hosts file with the server’s host 
name and IP address. If you don’t want to specify the server’s IP address (if you have a name service 
running on the network), you must specify a minus sign (-). 


mount_pt_name - The name of the mount point that the remote file system will be mounted on. 


mount_options - One or more mount options (-o option of the command) that are added to the 
/etc/vfstab entry for the specified mount_pt_name. 


Note: If you need to specify more than one mount option, the mount options must be separated by 
commas and no spaces. For example: ro, quota 
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Table 4-2. Profile Keyword and Profile Value Descriptions (6 of 10) 


Profile Values and Description 


slice size [file_system] [optional_parameters] 


This instance of filesys creates local file systems during the installation. You can specify filesys 
more than once. 


slice - Choose one of the following: 

e any - The Solaris installation program places the file system on any disk. 

Restriction: any cannot be specified when size is existing, all, free, start:size, or ignore. 

° cwtxdysz or cxdysz - The disk slice where the Solaris installation program places the file system, for 
example, cOt0d0s0. 

¢ rootdisk.sn - The logical name of the disk where the installation program places the root file 
system. The sn suffix indicates a specific slice on the disk. 


size - Choose one of the following: 

e num - The size of the file system is set to num (in Mbytes). 

e existing - The current size of the existing file system is used. 

Note: When using this value, you can change the name of an existing slice by specifying file-system as 

a different mount_pt_name. 

¢ auto - The size the file system is automatically determined depending on the selected software. 

* all - The specified slice uses the entire disk for the file system. When you specify this value, no other 
file systems can reside on the specified disk. 

e free - The remaining unused space on the disk is used for the file system. 

Restriction: If free is used as the value to filesys, it must by the last filesys entry in a profile. 

¢ start:size - The file system is explicitly partitioned: start is the cylinder where the slice begins; size is 
the number of cylinders for the slice. 
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Table 4-2 Profile Keyword and Profile Value Descriptions (7 of 10) 


Profile | | 
Keyword Profile Values and Description 


file_system - You can use this optional value when slice is specified as any or cwtxdysz. If file_system is 

not specified, unnamed is set by default, but then you can’t specify the optional_parameters value. Choose 

one of the following: 

e mount_pt_name - The file system’s mount point name, for example, /var. 

¢ swap - The specified slice is used as swap. 

® overlap - The specified slice is defined as a representation of a disk region (VTOC value is 
V_BACKUP). By default, slice 2 is an overlap slice that is a representation of the whole disk. 

Restriction: overlap can be specified only when size is existing, all, or start:size. 

e unnamed - The specified slice is defined as a raw slice, so slice will not have a mount point name. If 
file_system is not specified, unnamed is set by default. 

° ignore - The specified slice is not used or recognized by the Solaris installation program. This could 
be used to ignore a file system on a disk during an installation, so the Solaris installation program can 
create a new file system on the same disk with the same name. 


optional_parameters - Choose one of the following: 

e preserve - The file system on the specified slice is preserved. 

Restriction: preserve can be specified only when size is existing and slice is cwtxdysz. 

e mount_options - One or more mount options (-o option of the mount (1M) command) that are added 
to the /etc/vfstab entry for the specified mount_pt_name. 


Note: If you need to specify more than one mount option, the mount options must be separated by 
commas and no spaces. For example: ro, quota | 


install_type defines whether to perform the initial installation option or upgrade option on the 
system. | 


Restriction: install_type must be the first profile keyword in every profile. 
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Table 4-2 Profile Keyword and Profile Value Descriptions (8 of 10) 


Profile Values and Description 


locale_name _ 


locale designates that the localization packages associated with the selected software should be 
installed (or added for upgrade) for the specified locale_name. The locale_name values are the same as the 
values used for the $LANG environment variable. Solaris 2.5 supports the following localizations: 


Language locale name 


Chinese zh 
French fr 
German de 
Italian a 
Japanese ja 
Korean ko 
Latin American es 
Swedish SV 
Taiwanese zh_TW 


The English localization packages are installed by default. You can specify locale once for each 
localization you need to support. | 


When a server is installed, space is allocated for each diskless client’s root (/) and swap file systems. 
num_clients defines the number of diskless clients (client_num) that a server will support. If you do 
not specify num_clients, five diskless clients are allocated. 


Restriction: num_clients can be used only when system_type is specified as server. 
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Table 4-2. Profile Keyword and Profile Value Descriptions (9 of 10) 


Profile 
Keyword Profile Values and Description 


package designates whether a package should be added to or deleted from the software group that will 
be installed on the system. add or delete indicates whether the package should be added or deleted. If 
you do not specify add | delete, add is set by default. 


package_name must be in the form SUNWname. Use the pkginfo -1 command or Admintool (select 


Software from the Browse menu) on an installed system to view detailed information about packages 
and their names. 


For Upgrade: 
e All packages already on the system are automatically upgraded. 


e If you specify package_name add, and package_name is not installed on the system, the package is 
installed. 


e If you specify package_name delete, and package_name is installed on the system, the package is 
deleted before the upgrade begins. 


e If you specify package_name delete, and package_ name is not installed on the system, the package is 
prevented from being installed if it is part of a cluster that is designated to be installed. 
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Table 4-2 Profile Keyword and Profile Value Descriptions (10 of 10) 


Profile 
Keyword Profile Values and Description 
partitioning default | existing | explicit. 


partitioning defines how the disks are divided into slices for file systems during the installation. If 
you do not specify partitioning, default is set. 


default - The Solaris installation program selects the disks and creates the file systems on which to 
install the specified software, except for any file systems specified by the filesys keyword. rootdisk 
is selected first; additional disks are used if the specified software does not fit on rootdisk. 


existing - The Solaris installation program uses the existing file systems on the system’s disks. All file 
systems except /, /usr, /usr/openwin, /opt, and /var are preserved. The installation program uses 
the last mount point field from the file system superblock to determine which file system mount point 
the slice represents. 


Restriction: When specifying the filesys profile keyword with partitioning existing, size must 
be existing. 


explicit - The Solaris installation program uses the disks and creates the file systems specified by the 
filesys keywords. If you specify only the root (/) file system with the filesys keyword, all the 
Solaris software will be installed in the root file system. 


Restriction: When you use the explicit profile value, you must use the filesys profile keyword to 
specify which disks to use and what file systems to create. 


profile, standalone is set by default. 


usedisk designates a disk that the Solaris installation program will use when partitioning 
default is specified. You can specify usedisk once for each disk, and disk_name must be specified in 
the form cxtydz or cydz, for example, cOt0d0. 


If you specify the usedisk profile keyword in a profile, the Solaris installation program will only use 
the disks that you specify with the usedisk profile keyword. 


Restriction: You cannot specify the usedisk keyword and the dontuse keyword in the same profile. 
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How the Size of Swap Is Determined 


If a profile does not explicitly specify the size of swap, the Solaris installation 
program determines the maximum size that swap can be, based on the 
system’s physical memory. Table 4-3 shows how the maximum size of swap is 
determined during a custom JumpStart installation. 


Table 4-3 How the Maximum Size of Swap Is Determined 


Physical Memory (in Mbytes) Maximum Size of Swap (in Mbytes) 


16 - 64 32 
64 - 128 64 
128 - 512 128 
512 > 256 


The Solaris installation program will make the size of swap no more than 20% 
of the disk where it resides, unless there is free space left on the disk after 
laying out the other file systems. If free space exists, the Solaris installation 
program will allocate the free space to swap up to the maximum size shown in 
Table 4-3. 


Note — Physical memory plus swap space must be a minimum of 32 Mbytes. 
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What Is the rules File 


The rules file is a text file used to create the rules. ok file. The rules file is 


1 1 mY antfaann -_aAaAm Sse Ys ie aes aan 
a look-up table consisting of one or more rules that define matches between 


system attributes and profiles. For example, the rule 
karch sun4c - basic_prof - 


matches a system with a sun4c platform name to the basic_prof profile, 
which the Solaris installation program would use to install the system. 
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Note — If you set up the JumpStart directory by using the procedures on 

page 53 or page 62, an example rules file should already be in the JumpStart 
directory; the example rules file contains documentation and some example 
rules. If you use the example rules file, make sure you comment out the 
example rules that you will not use. 


When Does a System Matcha Rule 


During a custom JumpStart installation, the Solaris installation program 
attempts to match the rules in the rules. ok file in order: first rule through the 
last rule. A rule match occurs when the system being installed matches any of 
the rule values in the rule (as defined in Table 4-5 on page 88). As soon as a 
system matches a rule, the Solaris installation program stops reading the 
rules.ok file and begins to install the system as defined by the matched 
rule’s profile. 


Vv How to Create the rules File 


Overview — The procedure to create a rules file involves: 
° Editing a file 


® Selecting rule keywords and rule values for each group of systems you want 
to install using custom JumpStart. Any systems that match the rule keyword 
and rule value will be installed as specified by the corresponding profile. 


Follow this procedure to create a rules file. 


1. Open a file (the rules file) and name it rules. 
You can create a new file or edit the sample rules file provided in the 
JumpStart directory you created. 


2. Add a rule in the rules file for each group of systems you want to install 
using custom JumpStart. 
Be aware of these things as you add rules to the rules file: 


¢ Rule Examples on page 86 provides some examples of rules. 
¢ Table 4-5 on page 88 provides the list of valid rule keywords and values. 
¢ The rules file must have at least one rule 
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¢ A rule must have at least a rule keyword, a rule value, and a 
corresponding profile. 


A rule within the rules file must have the following syntax: 


Table 4-4 desa@ibas the fields of a rule. 


Table 4-4 Field Descriptions of a Rule 


Field Description 
! A symbol used before a rule keyword to indicate negation. 
[J A symbol used to indicate an optional expression or field. - 


A symbol used to indicate the preceding expression may be 
repeated. 


rule_keyword A predefined keyword that describes a general system 
attribute, such as host name (hostname) or memory size 
(memsize). It is used with the rule value to match a system 
with the same attribute to a profile. See Table 4-5 on page 88 for 
the list of rule keywords. 


rule_value A value that provides the specific system attribute for the 
corresponding rule keyword. See Table 4-5 on page 88 for the 
list of rule values. | 


&& A symbol that must be used to join (logically AND) rule 
keyword and rule value pairs together in the same rule. During 
a custom JumpStart installation, a system must match every 
pair in the rule before the rule matches. 
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Task 


Complete 


Table 4-4 Field Descriptions of a Rule (Continued) 


Field 


begin 


profile 


finish 


Description 


A name of an optional Bourne shell script that can be executed 
before the installation begins. If no begin script exists, you must 
enter a minus sign (-) in this field. All begin scripts must reside 
in the JumpStart directory. 


See “Creating Begin Scripts” on page 98 for detailed 
information on how to create begin scripts. 


A name of a text file used as a template that defines how to 
install Solaris on a system. The information in a profile consists 
of profile keywords and their corresponding profile values. All 
profiles must reside in the JumpStart directory. 


Note - There are optional ways to use the profile field, which 
are described in “Using a Site-Specific Installation Program” on 
page 111 and “Creating Derived Profiles With Begin Scripts” on 
page 98. 


A name of an optional Bourne shell script that can be executed 
after the installation completes. If no finish script exists, you 
must enter a minus sign (-) in this field. All finish scripts must 
reside in the JumpStart directory. 


See “Creating Finish Scripts” on page 100 for detailed 
information on how to create finish scripts. 


This completes the procedure to create a rules file. To validate the rules file, 
see How to Use check to Validate the rules File on page 94. 
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Rule Examples 


The following illustration shows several example rules in a rules file. Each 
line has a rule keyword and a valid value for that keyword. The Solaris 
installation program scans the rules file from top to bottom. When the Solaris 
installation program matches a rule keyword and value with a known system, 
it installs the Solaris software specified by the profile listed in the profile field. 


# rule keywords and rule valuesbegin script profile finish script 


hostname eng-1 basic_prof 

network 192.43.34.0 && !model \ 

'SUNW, Sun 4_50' = net_prof ~ 
model SUNW, SPARCstation-LxX - lx_prof complete 
network 193.144.2.0 && karch i86pcsetup x86_prof done 
memsize 16-32 && arch sparc - prog_prof ~ 
any - - generic_prof - 


0 
2 
© 
4 
15) 
6) 


@ This rule matches if the system’s host name is eng-1. The basic_prof 
y 
profile is used to install the Solaris software on the system that matches this 
rule. 


@ The rule matches if the system is on subnet 192.43.34.0 and it is not a 
SPARCstation IPX" (SUNW,Sun 4_50). The net_prof profile is used to 
install the Solaris software on systems that match this rule. 


® The rule matches if the system is a SPARCstation LX. The 1x_prof profile 
and the complete finish script are used to install the Solaris software on 
systems that match this rule. This rule also provides an example of rule 
wrap, which is defined on page 87. . 


® This rule matches if the system is on subnet 193.144.2.0 and the system is an 
x86. The setup begin script, the x86_prof profile, and the done finish 

script are used to install the Solaris software on systems that match this 

rule. 7 | | 

® This rule matches if the system has 16-32 Mbytes of memory and its 
processor type is SPARC. The prog_prof profile is used to install the 
Solaris software on systems that match this rule. 


© This rule matches any system that did not match the previous rules. The 
generic_prof profile is used to install the Solaris software on systems 
that match this rule. If used, any should always be in the last rule. 
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Important Information About the rules File 


The following information is important to know about the rules file: 


© Name - The rules file must have the file name, rules. 


® rules.ok file - The rules.ok file is a generated version of the rules file, 


and it is required by the custom JumpStart installation software to match a 
system to a profile. You must run the check script to create the rules.ok 
file, and the rules.ok file should be owned by root and have permissions 
equal to 644. | 


Comments - You can add a comment after the pound sign (#) anywhere on 
a line. If a line begins with a #, the entire line is a comment line. If a # is 
specified in the middle of a line, everything after the # is considered a 
comment. Blank lines are also allowed in the rules file. 


Note — When creating the rules. ok file, the check script removes all the 
comment lines, comments at the end of a rule, and blank lines. 


* Rule wrap - When a rule spans multiple lines, you can let a rule to wrap to 
a new line, or you can continue a rule on a new line by using a backslash (\) 
before the carriage return. 


® Rule fields - The rule_value, begin, and finish fields must have a valid entry 
or a minus sign (-) to specify that there is no entry. 
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Rule Keyword 
any 


arch 


domainname 


disksize 


hostaddress 


88 


Rule Keyword and Rule Value Descriptions 


Table 4-5 describes the rule keywords and rule values that you can use in the 


rules file. 


Table 4-5 Rule Keyword and Rule Value Descriptions (1 of 4) 


Rule Values 
minus sign (-) 


processor_type 


platform processor type 
SPARC sparc 
x86 i386 


domain_name 


disk_name_ size_range 


disk_name - A disk name in the form cxtydz, such as 
c0t3d0, or the special word rootdisk. rootdisk 
should be used only when trying to match systems that 
contain the factory-installed JumpStart software. 
rootdisk is described on page 91. 


size_range - The size of the disk, which must be specified 
as a range of Mbytes (xx-xx). 


IP_address 


Description 
Match always succeeds. 


Matches a system’s processor type. The 
uname -p command reports the system’s 
processor type. 


Matches a system’s domain name, which 
controls how a name service determines 
information. 


If you have a system already installed, the 
domainname command reports the system’s 
domain name. 


Matches a system’s disk (in Mbytes). 
Example: disksize c0t3d0 250-300 


The example tries to match a system with a 
c0t3d0 disk that is between 250 and 300 
Mbytes. 


Note: When calculating size_range, remember 
that a Mbyte equals 1,048,576 bytes. A disk 
may be advertised as a “207 Mbyte” disk, but 
it may have only 207 million bytes of disk 
space. The Solaris installation program will 
actually view the “207 Mbyte” disk as a 197 
Mbyte disk because 207,000,000 / 1,048,576 = 
197. So, a “207 Mbyte” disk would not match a 
size_range equal to 200-210. 


Matches a system’s IP address. 
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Table 4-5 Rule Keyword and Rule Value Descriptions (2 of 4) 


Rule Values 


host_name 


slice version 


slice - A disk slice name in the form cwtxdysz, such as 
c0t3d0s5, or the special words any or rootdisk. If any 
is used, any disk attached to the system attempts to 
match. rootdisk should be used only when trying to 


match systems that contain the factory-installed 


JumpStart software. rootdisk is described on page 91. 


version - A version name, such as Solaris 2.3, or the 
special words any or upgrade. If any is used, any 
Solaris or SunOS release is matched. If upgrade is used, 
any upgradable Solaris 2.1 or greater release is matched. 


platform_group 


Valid values are sun4d, sun4c, sun4m, or i86pc. (See 
Appendix C, “Platform Names and Groups” for a 


detailed list of platform groups and names.) 


physical_mem 


The value must be a range of Mbytes (xx-xx) or a single 


Mbyte value. 
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Description 


Matches a system’s host name. 


If you have a system already installed, the 
uname -n command reports the system’s host 
name. 


Matches a disk that has a root file system 
corresponding to a particular version of 
Solaris software. 


Matches a system’s platform name. 


If you have a system already installed, the 
arch -k command or the uname -m 
command reports the system’s platform 


group. 
Matches a system’s physical memory size (in 
Mbytes). 


Example: memsize 16-32 

The example tries to match a system with a 
physical memory size between 16 and 32 
Mbytes. 

If you have a system already installed, the 


prtconf command (line 2) reports the 
system’s physical memory size. 
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Table 4-5 Rule Keyword and Rule Value Descriptions (3 of 4) 


Rule Keyword Rule Values 


model model_name 


system 
Sun-4/110 


Sun-4 /2xx 

SPARCstation 1 (4/60) 
SPARCstation 1+ (4/65) 
SPARCstation SLC™ (4/20) 
SPARCstation IPC (4/40) 
SPARCstation ELC™ (4/25) 
SPARCstation IPX (4/50) 
SPARCstation 2 (4/75) 
Sun-4/3xx 

Sun-4/4xx 
SPARCserver™ 6xx 
SPARCstation 10 
SPARCclassic™ (4/15) 
SPARCstation LX (4/30) 
SPARCcenter™ 1000 
SPARCcenter 2000 
SPARCstation 10 SX 
SPARCstation 20 
SPARCstation 5 
SPARCstation Voyager 
Sun Ultra™ 1 Model 140 
x86 


model_name 

Sun 4_100 Series 
Sun 4_200 Series 
Sun 4_60 

Sun 4_65 

Sun 4_20 
SUNW;Sun 4_40 


SUNW,SUN 4_25 


SUNW,Sun 4_50 
SUNW,SUN 4_75 


Sun SPARCsystem 300 
Sun SPARCsystem 400 
SUNW,SPARCsystem-600 
SUNW,SPARCstation-10 
SUNW,SPARC classic 
SUNW,SPARCstation-LX 
SUNW,SPARCserver-1000 
SUNW,SPARCcenter-2000 
SUNW,SPARCstation-10,SX 
SUNW,SPARCstation-20 
SUNW,SPARCstation-5 


SUNW,S240 


SUNW, Ultra1-140 


i86pc 


Description 


Matches a system’s model number, which is 
system-dependent and varies by the 
manufacturer. The list shown may not be 
complete. 


If you have a system already installed, the 
prtconf command (line 5) reports the 
system’s model number. 


Note: If the model_name contains spaces, the 
model_name must be inside a pair of single 
quotes ('). For example: 'SUNW, Sun 4_50' 
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Table 4-5 Rule Keyword and Rule Value Descriptions (4 of 4) 


Rule Keyword Rule Values 


network network_num 
osname Solaris_version 
totaldisk size_range 


The value must be specified as a range of Mbytes (xx-xx). 


Description 


Matches a system’s network number, which 
the Solaris installation program determines by 
performing a logical AND between the 
system’s IP address and the subnet mask. 


Example: network 193.144.2.0 


The example would match a system with a 
193.144.2.8 IP address (if the subnet mask were 
255.255.255.0). 


Matches a version of Solaris already installed 
on a system. Solaris_version is the version of 
Solaris environment installed on the system: 
for example, Solaris_2.5. 


Matches the total disk space on a system (in 
Mbytes). The total disk space includes all the 
operational disks attached to a system. 


Example: totaldisk 300-500 


The example tries to match a system with a 
total disk space between 300 and 500 Mbytes. 


Note: When calculating size_range, remember 
that a Mbyte equals 1048576 bytes. A disk may 
be advertised as a “207 Mbyte” disk, but it 
may have only 207 million bytes of disk space. 
The Solaris installation program will actually 
view the “207 Mbyte” disk as a 197 Mbyte disk 
because 207000000 / 1048576 = 197. So, a “207 
Mbyte” disk would not match a size_range 
equal to 200-210. 


How the Installation Program Sets the Value of rootdisk 


rootdisk is the logical name of the disk where the root file system is placed 
during an installation. During a custom JumpStart installation, the Solaris 
installation program sets the value of rootdisk (that is, the actual disk it 
represents) depending on various situations; this is described in Table 4-6. 
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Table 4-6 How the Solaris Installation Program Sets the Value of rootdisk 


Situation 


A system contains the factory-installed 
JumpStart software. (this applies to 
some SPARC systems only). | 


rootdisk has not been set and a 
system tries to match the following 
rule: 


disksize rootdisk size_range 
or | 
installed rootdisk version 


If rootdisk has been set and the 
system tries to match the following 
rule. 


disksize rootdisk size_range 
or 
installed rootdisk version 


A system tries to match the following 
rule: 


installed disk version 


A system tries to match the following 
rule: 


installed any version 


What Happens 


rootdisk is set to the disk that contains 
the factory-installed JumpStart software 
before the system tries to match any rules. 


rootdisk is set to c0t3d0 or the first 
available disk attached to the system. 


After rootdisk is set, the system tries to 
match the rule. 


The system tries to match the rule. 


If disk is found on the system with a root 
file system that matches the specified 
version, the rule matches and rootdisk is 
set to disk. 


If any disk is found on the system with a 
root file system that matches the specified 
version, the rule matches and rootdisk is 
set to the found disk. (If there is more than 
one disk on the system that can match, the 
system will match the first disk that is 
found.) 
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Table 4-6 How the Solaris Installation Program Sets the Value of rootdisk (Continued) 


Situation What Happens 

rootdisk has not been set after a rootdisk is set to the first disk found with 

system matches a rule and the system _a root file system that matches an 

is going to be upgraded (which is upgradable version of Solaris software. If 

defined in the profile). no disk is found, the system proceeds with 
an interactive installation. 

rootdisk has not been set after a rootdisk is set to c0t3d0 or the first 

system matches a rule. available disk attached to the system. 


For the Solaris installation program to use the value of rootdisk, the 
following conditions must be true in the profile specified for the system: 


° Default partitioning is used. 


® No slice has been explicitly set for the root file system. 


Using check to Validate the rules File 


Before the rules file and profiles can be used, you must run the check script 
to validate that these files are set up correctly. The following table shows what 
the check script does. 


Stage Description 
1 The rules file is checked for syntax. 
check makes sure that the rule keywords are legitimate, and the 


begin, class, and finish fields are specified for each rule (the begin 
and finish fields may be a minus sign [-] instead of a file name). 


2 If no errors are found in the rules file, each profile specified in 
the rules is checked for syntax. 


3 If no errors are found, check creates the rules.ok file from the 
rules file, removing all comments and blank lines, retaining all 
the rules, and adding the following comment line to the end: 


# version=2 checksum=num 
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Vv How to Use check to Validate the rules File 


Overview — The procedure to use check to validate the rules file involves: 
® Making sure the check script resides in the JumpStart directory 


: Running the check script 


Follow this procedure to use check to validate the rules file. 


1. Make sure that the check script resides in the JumpStart directory. 


Note -— The check script is provided in the auto_install_samp]le directory 
on the Solaris CD. 


2. Change the directory to the JumpStart directory: 


S$ ed jumpstart_dir_path 


3. Run the check script to validate the rules file: 


§ ./check [-p path] [-r file_name] 


In this command, 


~p path Is the path to the Solaris 2.5 CD. You can use a 
Solaris CD image on a local disk or a mounted 
Solaris CD.This option ensures that you are using 
the most recent version of the check script. You 
should use this option if you are using check ona 
system that is running a previous version of 
Solaris. 


-r file_name Specifies a rules file other than the one named 
rules. Using this option, you can test the validity 
of a rule before integrating it into the rules file. 
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As the check script runs, it reports that it is checking the validity of the 
rules file and the validity of each profile. If no errors are encountered, it 
reports: The auto-install configuration is ok. 


The rules files is now validated. To read about the optional features 

available for custom JumpStart installations, see Chapter 5, “Using Optional 
Custom JumpStart Features.” To perform a custom JumpStart installation on 
a system, see Chapter 9, “Booting and Installing Solaris: Custom JumpStart.” 
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This chapter describes the optional features available for custom JumpStart 
installations, and it is a supplement to Chapter 4, “Preparing Custom 
JumpStart Installations.” You can use the following optional features to 
enhance and test custom JumpStart installations: 


°® Begin scripts 

¢ Finish scripts 

e rine ta wl: | 

® Site-specific installation program 

Note — This chapter is valid for either an x86 or SPARC server that is being 
used for custom JumpStart installations. An x86 server can provide custom 


JumpStart files for SPARC systems and a SPARC system can provide custom 
JumpStart files for x86 systems. 


oF 


e) 
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What Is a Begin Script 


A begin script is a user-defined Bourne shell script, specified within the rules 
file, that performs tasks before the Solaris software is installed on the system. 
Begin scripts can be used only with custom JumpStart installations. 


Important Information About Begin Scripts 


The following information is important to know about begin scripts: 


° Be careful that you do not specify something in the script that would 
prevent the mounting of file systems onto /a during an initial or upgrade 
installation. If the Solaris installation program cannot mount the file systems 
onto /a, an error will occur and the installation will fail. | 


® Output from the begin script goes to /var/sadm/begin. log. 


¢ Begin scripts should be owned by root and have permissions equal to 644. 


Ideas for Begin Scripts 
You could set up begin scripts to perform the following tasks: 
°® Creating derived profiles 


° Backing up files before upgrade 


Creating Derived Profiles With Begin Scripts 


A derived profile is a profile that is dynamically created by a begin script during 
a custom JumpStart installation. Derived profiles are needed when you cannot 
set up the rules file to match specific systems to a profile (when you need 
more flexibility than the rules file can provide). For example, you may need 
to use derived profiles for identical system models that have different 
hardware components (for example, systems that have different frame buffers). 


To set up a rule to use a derived profile, you must: 


° Set the profile field to an equal sign (=) instead of a profile. 
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° Set the begin field to a begin script that will create a derived profile 
depending on which system is being installed. 


When a system matches a rule with the profile field equal to an equal sign (=), 
the begin script creates the derived profile that is used to install the Solaris 
software on the system. 


An example of a begin script that creates the same derived profile every time is 
shown below; however, you could add code to this example that would create 
a different derived profile depending on certain command’s output. 


#!/bin/sh 

echo "install _type initial install" S${SI_PROFILE} 
echo "system_type standalone" S{SI_PROFILE} 
echo "oartitioning default" S{SI_PROFILE} 


echo "cluster SUNWCprog" S{SI_PROFILE} 
echo "package SUNWman delete" S{SI_PROFILE} 
echo "package SUNWolman delete" S{SI_PROFILE} 
echo "package SUNWxwman delete" S{SI_PROFILE} 


As shown above, the begin script must use the SI_PROFILE environment 
variable for the name of the derived profile, which is set to 
/tmp/install.input by default. 


Note — If a begin script is used to create a derived profile, make sure there are 
no errors in it. A derived profile is not verified by the check script, because it 
is not created until the execution of the begin script. 
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Creating Finish Scripts 
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What Is a Finish Script 


A finish script is a user-defined Bourne shell script, specified within the rules 
file, that performs tasks after the Solaris software is installed on the system, but 
before the system reboots. Finish scripts can be used only with custom 
JumpStart installations. 


Important Information About Finish Scripts 


_ The following information is important to know about finish scripts: 


¢ The Solaris installation program mounts the system’s file systems onto /a. 
The file systems remain mounted on /a until the system reboots. Therefore, 
you can use the finish script to add, change, or remove files from the newly 
installed file system hierarchy by modifying the file systems respective 
to /a. 


* Output from the finish script goes to /var/sadm/finish. log. 


° Finish scripts should be owned by root and have permissions equal to 644. 


Ideas for Finish Scripts 
You could set up finish scripts to perform the following tasks: 
° Installing patches 
° Restoring backed up files 
° Setting up print servers 
e ing entries to the automount map 
The following finish scripts are provided as examples: 
° Adding files 
* Customizing the root environment 


° Setting the system’s root password 
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Adding Files With Finish Scripts 


Through a finish script, you can add files from the JumpStart directory to the 
already installed system. This is possible because the JumpStart directory is 
mounted on the directory specified by the SI_CONFIG_DIR variable (which is 
set to /tmp/install_config by default). 


Note — You can also replace files by copying files from the JumpStart directory 
to already existing files on the installed system. 


The following procedure enables you to create a finish script to add files to a 
system after the Solaris software is installed on it: 


1. Copy all the files you want added to the installed system into the JumpStart 
directory. 


2. Insert the following line into the finish script for each file you want copied 
into the newly installed file system hierarchy. 


cp ${SI_CONFIG_DIR}/file_name /a/path_name 


For example, assume you have a special application, site_prog, developed 
for all users at your site. If you place a copy of site_prog into the 
JumpStart directory, the following finish script would copy the site_prog 
from the JumpStart directory into a system’s /usr/bin directory during a 
custom JumpStart installation: 


#!/bin/sh 


cp S${SI_CONFIG_DIR}/site_prog /a/usr/bin 
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Customizing the Root Environment 


Through a finish script, you can customize files already installed on the 
system. For example, the following finish script customizes the root 
environment by appending information to the .cshrc file in the root directory. 


#!/bin/sh 
+ 
# Customize root’s environment 


# 

echo '"***adding customizations in /.cshrc' 

test -f£ a/.cshre.|| { 

cat >> a/.cshrce <<EOF 

set history=100 savehist=200 filec ignoreeof prompt="\Suser@*‘uname -n*> "| 
alias cp cp -i 


alias mv mv -i 
alias rm rm -i 
alias ls ls -FC 
alias h history 
alias c clear 
unset autologout 
EOF 


Setting the System’s Root Password With Finish Scripts 


After Solaris software is installed on a system, the system reboots. Before the 
boot process is completed, the system prompts for the root password. This 
means that until someone enters a password, the system cannot finish booting. 


The auto_install_sample directory provides a finish script called 
set_root_pw that sets the root password for you. This allows the initial 
reboot of the system to be completed without prompting for a root password. 
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The set_root_pw file is shown below. 


#1 /bin/sh 
@Q@(#)set_root_pw 1.4 93/12/23 SMI 


This is an example bourne shell script to be run after installation. 

It sets the system’s root password to the entry defined in PASSWD. 

The encrypted password is obtained from an existing root password entry 
in /etc/shadow from an installed machine. 


echo "setting password for root" 


# set the root password 
PASSWD=dKO5IBKSF421w 
mv /a/etc/shadow /a/etc/shadow.orig 
nawk -F: '{ 
Le a St. SS oor” 4 
printf£"%s:%s:%s:%s:%8:%8:%s:%s:%s\n",$1,passwd,$3,$4,$5,$6,$7,$58,$9 
else | 
printf£"%s:%8:%8:%8:%8s:%8:%8S:%8:%s\n",$1,52,53,84,55,$56,$57,$8,89 
}' passwd="SPASSWD" /a/etc/shadow.orig > /a/etc/shadow 


# set the flag so sysidroot won’t prompt for the root password 
sed -e 's/0# root/1# root/' S{SI_SYS_STATE} > /tmp/state.$s$ 
mv /tmp/state.ss S${SI_SYS_ STATE} 


There are three main things you must do to set the root password in a finish 
script. 


@ Set the variable PASSWD to an encrypted root password obtained from an 
existing entry in a system’s /etc/shadow file. 


@ Change the root entry in the /etc/shadow file for the newly installed 
system using $PASSWD as the password field. 


® Change the entry from 0 to a 1 in the state file, so that the user will not be 
prompted for the root password. The state file is accessed using the variable 
SI_SYS_STATE, whose value currently is /a/etc/.sysIDtool.state. 
(To avoid problems with your scripts if this value changes, always reference 
this file using $ST_SYS_STATE.) The sed command shown here contains a 
tab character after the 0 and after the 1. 
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Note — If you set your root password by using a finish script, be sure to 
safeguard against those who will try to discover the root password from the 
encrypted password in the finish script. 


Using pfinstal] to Test Profiles 


Why Use pfinstall 


When install_type initial_instal1 is defined in a profile, you can use 
the pfinstall command to test the profile without actually installing the 
Solaris software on a system.pfinstall shows the results of how a system 
would be installed according to the specified profile, before you actually 
perform a custom JumpStart installation. 


Note — You cannot use pfinstal1 to test a profile using the upgrade option 
(when the initial_type upgrade is defined in a profile). 


Ways to Use pfinstall 


pfinstall enables you to test a profile against: 
¢ The system’s disk configuration where pfinstal1 is being run. 


° A disk configuration file that you can create with the prtvtoc command. A 
disk configuration file is a file that represents a structure of a disk (for 
example, bytes/sector, flags, slices). Disk configuration files enable you to 
use pfinstall from a single system to test profiles on different sized disks. 


You must run pfinstall on an x86 system to test profiles for x86 systems 
(using the x86 system’s disk configuration or an x86 disk configuration file). 
Conversely, you must run pfinstall on a SPARC system to test profiles for 
SPARC systems (using the SPARC system’s disk configuration or a SPARC disk 
configuration file). | 
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VW How fo Use pfinstall to Test a Profile 


Overview — The procedure to use pfinstal1 to test a profile involves: 
¢ Changing the directory to the JumpStart directory 

° Using the pfinstall command to test the profile 

Follow this procedure to use pfinstall to test a profile. 


1. To test the profile with a specific system memory size, set SYS_MEMSIZE to 
the specific memory size in Mbytes: 


S$ SYS_MEMSIZE=memory_size 


S export SYS _MEMSIZE 


2. Change the directory to the JumpStart directory where the profile resides: 


S ed jumpstart_dir_path 


For example, the following command would change the directory to the 
jumpstart directory on the root file system. | 


cd /jumpstart 


3. Run the pfinstall -dorpfinstall -D command to test the profile: 


Caution — Without the -d or -D option, pfinstal1 will install the Solaris 
software on the system by using the specified profile, and the data on the 
system will be overwritten. 


S$ /usr/sbin/install.d/pfinstall -D | -d disk_config [-c path] profile 


In this command, 


-D Tells pfinstall to use the current system’s disk 
configuration to test the profile against. You must 
be root to execute pfinstall with the -D option. 
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-d disk_config Tells pfinstall to use a disk configuration file, 
disk_config, to test the profile against. 


—c path Is the path to the Solaris CD. This is required if the 
Solaris CD is not mounted on /cdrom. (For 
example, use this option if you copied the Solaris 
CD image to disk or mounted the Solaris CD on a 
directory other than /cdrom). 


profile The name of the profile to test. 


Note — You should run pfinstall ona system running the same version of 
Solaris software that will be installed by the profile. Otherwise, use 
pfinstall on the Solaris CD that will be installed by the profile, which is 
located in the /export/exec/arch.Solaris 2.4/sbin/install.d 
directory. 


Run pfinstall from the directory where the profile and disk_config files 
reside (which should be the JumpStart directory). If the profile or disk_config 
file is not in the directory where pfinstall1 is run, you must specify the 


path. 


4. Check to see if the results of pfinstall are as you expected. If not, 
change the profile and go to Step 3. 


Task ) You have completed testing the profile. To perform a custom JumpStart 
Complete | installation on a system, see Chapter 9, “Booting and Installing Solaris: Custom 
JumpStart.” 


pfinstall Examples 


Below are some examples of using pfinstall to test the basic_prof profile 
against the 104_test disk configuration file: 


/usr/sbin/install.d/pfinstall -D basic_prof 
/usr/sbin/install.d/pfinstall -d 104_test basic_prof 


/usr/sbin/install.d/pfinstall -D -c /export/install basic_prof 
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Vv How to Create a Disk Configuration File for a SPARC System 


Task 
Complete 


A disk configuration file is a file that represents a structure of a disk (for 
example, bytes/sector, flags, slices). Disk configuration files enable you to use 
pfinstall from a single system to test profiles on different sized disks. 


Overview - The procedure to create a disk configuration file for a SPARC 
system involves: 


° Locating a SPARC system with a disk that you want to test a profile against 


° Using the prtvtoc(1M) command to create the disk configuration file 
Follow this procedure to create a disk configuration file. 

1. Locate a system with a disk that you want to test a profile against. 

2. Determine the device name for the system’s disk. 


3. Redirect the output of prtvtoc to create the disk configuration file: 


S prtvtoc /dev/rdsk/device_name. > disk_config 


In this command, 


/dev/xrdsk/device_name Is the device name of the system’s disk. 
device_name must be in the form cwtxdys2 or 
cxdys2. 


Note: Slice 2 must be specified in device_name. 


disk_config Is the disk configuration file name. 


4, Copy the disk configuration file to the JumpStart directory: 


S$ ep disk_config jumpstart_dir_path 


You have completed creating a disk configuration file. The following page 
provides an example of creating a disk configuration file. 
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The following example creates a disk configuration file, 104_test, ona 
system with a 104-Mbyte disk, whose device name is c0t3d0s2. 


S prtvtoc /dev/rdsk/c0Ot3d0s2 > 104 test 


In this example, the 104_test file contains the following information: 


cat 104 test 
/dev/rdsk/c0t3d0s2 partition map 


Dimensions: 
oi2 bytes/sector 
35 sectors/track 
6 tracks/cylinder 
210 sectors/cylinder 
1019 cylinders 
974 accessible cylinders 


Flags: 
1: unmountable 


10: read-only 


Purse Sector Last 


# 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
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0 2 00 
a 3 00 
2 5 00 
6 4 O1 


0 
16170 
0 
44310 


Partition Tag Flags Sector Count Sector Mount Directory 


Let 70 
28140 
204540 
160230 
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Vv How to Create a Multiple Disk Configuration File for a SPARC System 


If you need to test a profile on multiple disks, you can concatenate disk 
configuration files together to create multiple disk configuration scenarios. 


Overview — The procedure to create a multiple disk configuration file for a 
SPARC system involves: 


* Concatenating two or more disk configuration files into one file 


° Changing the target numbers of the disks (if needed) 


The following procedure creates a disk configuration file to test a profile on 
two 104-Mbyte disks: 


1. Concatenate the 104_test file with itself and save the output to another 
file: 


S cat 104 test 104 test > dual_104 test 


2. Make sure that each disk device name is specified with a different target. 
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For example, the dual_104_test file is shown as follows: 


cat dual_104 test 
/dev/rdsk/cO0t3d0s2 partition map 


Dimensions: 
512 bytes/sector 
35 sectors/track 
6 tracks/cylinder 
210 sectors/cylinder 
1019 cylinders 
974 accessible cylinders 


Flags: 
1: unmountable 
10: read-only 


¥  * F F FF F F F F F *F F F F FE 


Partition Tag Flags Sector Count 
0 2 a 00 0 6170 
i 3 00 16170 28140 
2 5 00 0 204540 
6 4 Oz 44310 160230 
/dev/rdsk/cO0Ot0d0s2 partition map 


Dimensions: 
512 bytes/sector 
35 sectors/track 
6 tracks/cylinder 
210 sectors/cylinder 
1019 cylinders 
974 accessible cylinders 


Flags: 
1: unmountable | 
10: read-only 


+ + £ F F F F F F F F F F F HF F 


ANF © 
H UOT W 
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First Sector 


First Sector 
Partition Tag Flags Sector Count 
2 00 0 16170 
00 16170 28140 
00. 0 204540 
O01 44310 1602/30 


Last 
Sector Mount Directory 
16169 
44309 
204539 
204539 


Last | 
Sector Mount Directory 
16169 
44309 
204539 
204539 


nN 
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This is what was done to the dual_104_ test file: 
O The first disk device name was not changed. 


@ The second disk device name was changed from /dev/rdsk/c0t3d0s2 
to /dev/rdsk/c0t0d0s2. This gives each disk a different target. 


Task 


Complete You have completed creating a multiple disk configuration file. 


Using a Site-Specific Installation Program 


Through the use of begin and finish scripts, sites with special requirements can 
install the Solaris software by creating their own installation program. When a 
minus sign (-) is specified in the profile field, the begin and finish scripts 
control how the system is installed, instead of the profile and the Solaris 
installation program. 


For example, if the following rule would match, the x_install.beg begin 
script and the x_install1. fin finish script would install the system named 
sherlock (the Solaris installation program would not be used): 


hostname sherlock x_install.beg - x_install.fin 
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Overview 


Can You Use Upgrade? 


Preparing a System for Upgrade 6 


This chapter provides some guidelines for performing an upgrade installation 
and for preserving local modifications before upgrading from a previous 
version of Solaris software. 


Upgrade and initial are options in the Solaris installation program that 
determine how Solaris software is copied to disk: 


° Upgrade - This option merges the new version of Solaris software with 
existing files on the system’s disk. It saves as many local modifications as 
possible. 


¢ Initial —- This option overwrites the system’s disk with the new version of 
Solaris software. 


Note — The upgrade option is not available for 4.1.x systems. Because you must 


use the initial installation option, backing up your data is critical. See the 
Solaris 1.x to Solaris 2.x Transition Guide for information. 


To determine if your system supports the upgrade, see the following table. 
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Upgrade Option Is Available 


If at least one disk attached to the system has a Solaris 2.1 or later root file system. 


1) To determine if the system has a root file system, type the following command: 
Bi 
Look for a line of output similar to the following: — 


Filesystem kbytes used avail capacity Mounted on 
/dev/dsk/c0t1d0s048295 15665 27810 36% / 


2) To determine if the system is running Solaris 2.1 or later, type the following 
commands: 


cd /var/sadm/softinfo 
more INST_RELEASE 


Note — The upgrade option may require deleting software packages if the disk 
is full; this requires knowledge of packages and dependencies. 


Upgrading and Install Patches 


You do not need to back out install patches before performing an upgrade. 


Check Other Software Documentation 


Check the documentation of other software you are running (e.g. Solstice” 
DiskSuite™, FrameMaker®) before using the upgrade option. There may be 
additional instructions you need to follow to preserve existing configurations. 


If You're Using Custom JumpStart 


Make sure you change the profile keyword from initial to upgrade in your 
profiles. 
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If You Override the Boot File Location 


For Solaris 2.5 and later, the kernel resides in 
/platform/<arch>/kernel/unix; notin /kernel/unix.If you override 
the boot file location by explicitly setting it to kernel /unix, you can 
successfully install Solaris software, but you won’t be able to boot the system. 


Upgrading Dataless Clients 


Dataless clients do not get automatically upgraded when the OS server is 


upgraded. After upgrading the OS server, you must perform an upgrade on 
dataless clients. 


Important Files For Upgrading 


The following files must be present on standalone systems, servers, and each 
diskless client being upgraded: 


/var/sadm/softinfor/INST_RELEASE 
/var/sadm/install/contents 
/jvaxr/sadm/install- data. clustertoc 


/var/sadm/install_data/CLUSTER 


Backing Up Your System 


Always back up an existing system before using the upgrade option and 
installing a new version of Solaris software. The safest backup to perform is a 
level 0 dump of all the file systems connected to the system being upgraded. If 
you do not have an established backup procedure, see System Administration 
Guide, Volume I. 
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Preserving Local Modifications 


What to Do Before 
Upgrading 


Preserve symbolic 
links 


Preserve symbolic 
links to automounted 
file systems 
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During an upgrade, the Solaris installation program attempts to preserve local 
modifications to the system whenever possible; however, sometimes local 

modifications can make an upgrade fail or perform differently than you would 
expect. Table 6-1 indicates tasks you should perform before upgrading to make. 
your upgrade a success. 


Table 6-1 Preserving Local Modifications 


How to Why 

Replace symbolic links that use During an upgrade, the installation program cannot 
absolute paths with symbolic links reference symbolic links that use absolute paths, because 
that use relative paths. the Solaris installation program mounts the root (/) file 


system at /a. For example, a symbolic link to 
For example, if /usr/openwinisa /export/openwin would fail, because during an 
symbolic link to upgrade, /export/openwin is really 
| /a/export/openwin. 
/export/openwin | | 
When the Solaris installation program cannot reference a 
symbolic link, it will overwrite the symbolic link and 
install the software (the installation program doesn’t 


change the symbolic link to 


re eet ar eae think the software exists). As a result, duplicate software 
will be installed on the system and the upgrade may fail 
because of insufficient disk space. 
Remove packages (by using The automounter is not active during an upgrade, so the 
Software Manager or the pkgrm Solaris installation program installs any package’s files or 
command) that will create files or directories that are symbolic links to automounted file 
directories currently automounted. systems. If a symbolic link is overwritten, the upgrade 


may fail because of insufficient disk space. 


(If you cannot remove a package, you can replace the 
symbolic link after the upgrade is completed.) 


Note: The /var/mail and /var/news directories, which 


usually reside on an automounted file system, are not 
affected by an upgrade. 
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What to Do Before 
Upgrading 


Prevent unneeded 
file systems from 
being mounted 


Table 6-1 Preserving Local Modifications (Continued) 


How to 


Comment out file systems in the 
/etc/vftstab file that you do not 


want mounted during an upgrade. 


Why 


During an upgrade, the Solaris installation program 
attempts to mount all the file systems listed in the 
/etc/vfstab file on the root file system being 
upgraded. If the Solaris installation program cannot 
mount a file system, it reports the failure and exits. 


Preparing a System for Upgrade 
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Booting and Installing Solaris: 
JumpStart 


This chapter describes how to perform a JumpStart installation. 
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Make sure you have a new system with the JumpStart 
software. 


If the New System Is A ... Then ... 

SPARCclassic™™ You can use the JumpStart method of 
SPARCstation™ IPX _ installing the Solaris software 
SPARCstation LX described in this chapter. 
SPARCstation 5. 


SPARCstation 10 
SPARCstation 10 SX 
SPARCstation 20 
SPARCstation” Voyager 


None of above | You must use the interactive method 
or custom JumpStart method; go back 
to “Choose a method for installing 
Solaris software.” on page 11 


If the JumpStart software is installed on a system, the Customer Information 
sheet, which is attached to the outside of the system’s packing box, will have 
the following entry, 


PRE-INSTALLED SOFTWARE 
mone [CODE PIIUMPSTART 1 Si 


and the “JumpStart for SPARC Systems” document will be included with the 


system’s hardware documentation. 
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Make sure you have reviewed the task map for a 
JumpStart installation (shown in Figure 2-2 on page 13). 


Make sure the Solaris software that will automatically be 


installed meets your needs. 


And the Size of 
Its Formatted, 
Internal Disk is 
Between ... 


200 - 9999 Mbytes 


If the System is A ... 


SPARCstation Voyager 


SPARCstation 10 SX 
SPARCstation 20 


SPARCstation 10 SX 
SPARCstation 20 


SPARCstation 5 


320 - 430 Mbytes 


431 - 9999 Mbytes 


N/A 


SPARC classic 
SPARCstation IPX 
SPARCstation LX 
SPARCstation 10 


98 - 108 Mbytes 


SPARC classic 
SPARCstation IPX 
SPARCstation LX 
SPARCstation 10 


109 - 9999 Mbytes 
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Then the Following Solaris Software is 
Installed ... 


Core software group, including the 
following SUNW packages: audio, bnur, 
bnuu, lpr, lpu, tltk, xilrt, xildg, xiler, 
xilow, libms, owrqd, admfw, inst, 
admap, loc, doc, apppr, apppu, pppk 


Developer software group and the 
SUNWCsx cluster 


Entire distribution software group 


End user software group and the 
SUNWCtcx cluster | 


Core software group, including the 
following SUNW packages: admr, 
admap, admfw, bcp, esu, inst, ipc, lpr, 
Ipu, too 


End user software group 
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4 If you are using the system’s local CD-ROM drive to install 
the Solaris software, prepare the CD-ROM drive. 


The following instructions cover the most common types of CD-ROM drives. If 
your CD-ROM drive is not one of the following types, see your hardware 
manual for instructions. 


CD-ROM Drive - Caddy Version CD-ROM Drive - Tray Version 

@ To open the caddy, pinch the @ Press the eject button on the 
corners while lifting the lid at front panel of the CD-ROM drive 
the center lip. (a tray will emerge if you have 


this type of caddy). 


@ Insert the Solaris CD (logo up) 
and close the caddy. 


@ Insert the Solaris CD (logo up) 
into the tray. 


© Push the tray back into CD-ROM 
drive. | 


© With the arrow on the caddy 
pointing toward the CD-ROM 


drive, insert the caddy. 
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Task 
Complete 


/ 


Turn on the components in the order recommended in 
your hardware guide. 


If System Begins to Boot ... If System Displays the > or ok Prompt ... 
You will see messages displayed on Your system does not have the JumpStart 
the screen indicating hardware and software. Go back to page 11 and choose 


system components are being checked. another method of installing Solaris 
The booting phase can last for several software. 
minutes. 


Note: During the booting phase, 
OpenWindows is started for 
localization reasons, or for the 
graphical user interface; however, 
OpenWindows is not fully installed 
until Solaris software is installed. 


If prompted, provide information about the system. 


After the booting phase, the Solaris installation program may be displayed on 
the screen, prompting you to provide information about the system. 


Wait as the Solaris installation program automatically 
installs the Solaris software on the system. 
You’re done for awhile; installing the Solaris software can take between 15 


minutes and 2 hours. After a successful installation, the system will reboot and 
you’re ready for Step 8. 


Start the OpenWindows software to display the desktop: 


S$ /usr/openwin/bin/openwin 


For post-installation information, see Chapter 11, “Where to Go After Installing 
Solaris.” 
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Booting and Installing Solaris: 
Interactive 8 


This chapter provides procedures to boot a system and perform an interactive 
installation using the Solaris installation program. If you’re using the: 


° Initial installation option — you can choose the defaults shown and have 
software automatically laid out for you, or you can customize the software 
and file system layout. 


° Upgrade option — you choose the disk for upgrading, add or delete software 
if desired, then start the upgrade. 


The procedure in this chapter should be done on the system that is being 
installed. 
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1 If you are using the system’s local CD-ROM drive to install 
the Solaris software on the system, prepare the CD-ROM 
drive. 


The following instructions cover the most common types of CD drives. If your 
CD drive is not one of the following types, see your hardware manual for 


instructions. — 
CD-ROM Drive - Caddy Version CD-ROM Drive - Tray Version 
@ To open the caddy, pinch the @ Press the eject button on the 
corners while lifting the lid at front panel of the CD-ROM 
the center. drive (a tray will emerge if 


you have this type of caddy). 


@ Insert the Solaris CD (logo up) 
and close the caddy. 


@ Insert the Solaris CD (logo 
up) into the tray. 


© Push the tray back into 
CD-ROM drive. 


© With the arrow on the caddy 
pointing toward the CD-ROM 
drive, insert the caddy. 
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2 Make sure you’ve reviewed the task map for an 
interactive installation (Figure 2-3 on page 14). 


3. If you are installing a system connected through a tip line, 
ensure that your window display is at least 80 columns 
wide and 24 rows long. 


Otherwise, the character installation interface will display improperly. You can 
use the stty command to find out the current dimensions of your tip window. 


4 Follow these instructions before you boot the system: 


If The System Is ... Then ... 


Off 1) Turn on the system components in the order 
recommended in the hardware guide. 
Caution: If the system starts booting, press L1-A or 
Stop-A. 
2) Go to Step 5. 


On — 1) If the system is running Solaris, enter the following 
commands: 
S su root 
# halt 
2) Go to Step 5. 


5 If the screen displays the > prompt instead of the ok 
prompt, then enter n and press Return. 


The screen should now display the ok prompt. 
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During the booting phase, 
OpenWindows may be 
started for localization 
reasons, or for the graphical 
user interface; however, 
OpenWindows is not fully 
installed until the Solaris 
software is installed. 
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Boot the system using the appropriate boot command: _ 


And The System You Are 


If You Are Booting ... Booting Is ... Then Enter ... 
From a server on the n/a | boot net 
network 

From the system’s local SPARCstation 1 (4/60) boot sd(0,6,2) 
CD-ROM drive SPARCstation 1+ (4/65) 


SPARCstation SLC™ (4/20) 
SPARCstation IPC™ (4/40) 


SPARCengine” 1E boot sd(0,6,5) 


All other Sun systems boot cdrom 


Wait for booting to complete. 


After you type the boot command, the system goes through a booting phase 
where hardware and system components are checked. This lasts for several 
minutes. The following screen provides an example of what you should see. 


Type b (boot), c (continue), or n (new command mode) 

>n | 

Type help for more information 

ok boot sd(0,6,2) 

Booting from: sd(0,6,2) . 

SunOS Release 5.4 Version [UNIX(R) System V Release] 
Copyright (c) 1983-1994, Sun Microsystems, Inc. 

WARNING: clock gained 35 days -- CHECK AND RESET THE DATE! 
Configuring the /devices directory | 


Configuring the /dev directory 
Starting OpenWindows... 


Install the Solaris software on the system by using the 
Solaris installation program displayed on the screen. 


You are now in the hands of the Solaris installation program. This menu- 


_ driven, interactive program guides you step-by-step through installing Solaris 


software; it also has online help to answer your questions. As shown below, the 
program has two interfaces to accommodate different hardware. 
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If you want to record your responses, use the work sheet in Appendix A, 
“Worksheets for the Solaris Installation Program.” There is also a time zone 
map on page 178 to help you set your system’s time clock. 


If Your System Has A ... Then the Interface Is ... And the Navigation Device Is ... 


Graphics-based Mouse 


Graphics monitor 
The Solaris Installation Program 


You are now interacting with the Solaris 

installation program. The program is divided 
into a series of short sections. At the end of 
each section, you will see a summary of the 


choices you’ve made, and be given the 
opportunity to make changes. 


Continue | 


Character-based Keyboard 


Non-graphics monitor, 
or an unsupported 


graphics card You are now interacting with the Solaris 
installation program. The program is di- 
vided into a series of short sections. At 
the end of each section, you will see a 
summary of the choices you've made, and 


--- The Solaris Installation Program 


be given the opportunity: to make changes. 


F2_ Continue F5_Help 


9 If you used the upgrade option, see Chapter 10, — 
“Completing an Upgrade,” for information needed to 


complete an upgrade. 


You must reboot the system after an upgrade. 
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10 Start the OpenWindows software to display the desktop: 


S /usr/openwin/bin/openwin 


11 If you‘ve allocated space for diskless clients, dataless 
clients, or AutoClient systems during the Solaris installation 
program, you must use the Solstice Host Manager to 
complete set up of these clients. 


The Solaris installation program only allocates space for clients during an 
initial installation. The Solstice Host Manager completes client set up by 
providing their required directories. See the System Administration Guide, 
Volume I. 


Task , For post-installation information, see Chapter 11, “Where to Go After Installing 
Complete | Solaris.” 
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Booting and Installing Solaris: 
Custom JumpStart 9 


This chapter provides a procedure to boot a system and perform a custom 
JumpStart installation using profiles you've created to install Solaris software. 
If you’re using the: 


° Initial installation option — Solaris software is automatically installed on 
the system after you boot the system (or turn on the system in some cases). 


® Upgrade option — the system is automatically upgraded to new version of 
Solaris software after you boot the system. 


The procedure in this chapter should be done on the system that is being 
installed. 
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1 If you are using the system’s local CD-ROM drive to install 
the Solaris software on the system, prepare the CD-ROM 
drive. 


The following instructions cover the most common types of CD drives. If your 
CD drive is not one of the following types, see your hardware manual for 


instructions. 

CD-ROM Drive - Caddy Version CD-ROM Drive - Tray Version 

® To open the caddy, pinch the @ Press the eject button on the 
corners while lifting the lid at front panel of the CD-ROM drive 
the center lip. (a tray will emerge if you have 


this type of caddy). 


@ Insert the Solaris CD (logo up) 
and close the caddy. 


@ Insert the Solaris CD (logo up) 
into the tray. 


© Push the tray back into CD- ROM 
drive. 


® With the arrow on the caddy 
pointing toward the CD-ROM 
drive, insert the caddy. 
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2 Make sure you reviewed the task map for a custom 
JumpsSiart installation (shown in Figure 2-4 on page 15). 


3 If you are using a diskette to perform a custom JumpStart 
installation, insert a diskette that contains a JumpStart 
directory into the system’s diskette drive. 


4 Follow the instructions before you boot the system: 


If the system has the JumpStart software installed (on new or re-preinstalled 
systems), turn on the system and go to Step 7. 


If The System Is ... Then ... 
Off 1 


— 


Turn on the system components in the order 
recommended in the hardware guide. 

Caution: If the system starts booting, press L1-A or 
Stop-A. 


2) Go to Step 5. 


O 
5 
SS 2 


If the system is running Solaris, enter the following 
commands: 

S su root 

# halt 


2) Go to Step 5. 


ww 


5 If the screen displays the > prompt instead of the ok 
prompt, then enter n and press Return. 


The screen should now display the ok prompt. 
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Boot the system using the appropriate boot command: 


If You Are Booting ... 


From a server on the 
network 


From the system’s 
local CD-ROM drive 


And the System You Are 


Booting Is ... Then Enter ... | 
nia boot nee install 
SPARCstation 1 (4/60) boot sd(0,6,2) - install 


SPARCstation 1+ (4/65) 
SPARCstation SLC (4/20) 
SPARCstation IPC (4/40) 


SPARCengine 1E boot sd(0,6,5) - install 


All other Sun systems boot cdrom - install 


1, | A space is required between the minus sign and install. 
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7 Wait for booting to be completed. 


After you type the boot command, the system will go through a booting phase 
where various hardware and system components are checked. The following 
screen provides an example of what you should see: 


Type b (boot), c (continue), or n (new command mode) 
>n 

Type help for more information 

ok boot net - install 

Booting from: le(0,0,0) - install 

2oc00 hostname: sherlock 

domainname: england.com 

root server: london 


TOOL Grrectory: 
/cdrom/solaris_2_5 sparc/s0/export/exec/kvm/sparc.sun4c.Solaris_2.4 


SunOS Release 5.5 Version [UNIX(R) System V Release] 
Copyright (c) 1983-1994, Sun Microsystems, Inc. 

Configuring the /devices directory 

Configuring the /dev directory 

Searching for JumpStart directory...using london:/jumpstart 
Starting OpenWindows... 


Note — The booting phase will last for a few minutes. 


8 If prompted, provide information about the system. 


After the booting phase, the Solaris installation program may be displayed on 
the screen, prompting you to provide information about the system. 


9 Wait as the Solaris installation program automatically 
installs the Solaris software on the system. 


You’re done for awhile; installing Solaris software can take between 15 minutes 
and 2 hours. 


Booting and Installing Solaris: Custom JumpStart 135 


136 


10 


1] 


12. 


Task 
Complete 


Start the OpenWindows software to display the desktop: 


S /usr/openwin/bin/openwin 


If you used the upgrade option, see Chapter 10, 
“Completing an Upgrade,” for information needed to 
complete an upgrade. 


You must reboot the system after an upgrade. 


If you installed Solaris on a server and allocated space for 
diskless clients, dataless clients, or AutoClient systems, 
and you selected the initial installation option, you must 
use the Solstice Host Manager to complefe set up of these 
clients. 


The Solaris installation program only allocates space for clients during an 
initial installation. The Solstice Host Manager completes client set up by 
providing their required directories. See the System Administration Guide, 
Volume I. 


For post-installation information, see Chapter 11, “Where to Go After Installing 
Solaris.” 
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Overview 


This chapter describes files to check and steps for completing an upgrade. 


What Happened During the Upgrade 


A record of what the installation program did during an upgrade can be 
important to determine if the upgrade was a success. The output of the 
upgrade is saved in the following files: 


° If upgrade fails —- /a/var/sadm/system/logs/upgrade_log 


° If upgrade completes and system reboots — 
/var/sadm/system/logs/upgrade_log 


Cleaning Up the System After an Upgrade 


During an upgrade, the Solaris installation program merges local software 
modifications of the existing system with the new software; however, in some 
cases, it is not possible. The following file provides a list of the unpreserved 
local modifications during the upgrade that may need to be fixed: 


° If upgrade fails --/a/var/sadm/system/data/upgrade_cleanup 


° If upgrade completes and system reboots — 
/var/sadm/system/data/upgrade_cleanup 
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Table 10-1 provides the entry descriptions of the unpreserved local 
modifications that may be found in the upgrade cleanup file. 


Table 10-1 Entry Descriptions of the upgrade_cleanup File 


Entry 
file1: existing file renamed to file2 


| file1: existing file preserved, the new version was 
installed as file2 


file: had been deleted and has now been restored 


file: file type was changed from typel to type2 


file: target of symbolic link was changed from target1 
to target2 


file1: target of hard link was changed from file2 


the original hard link. 
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Explanation 


filel was on the system at the time 
of the upgrade. It had been 
modified since its original 
installation, so upgrade renamed 
file1 to file2 and saved the new file 
as file1. 


filel has been preserved, and 
upgrade installed the new version 
of the file as file2. 


file had been deleted from the 
system since its original 
installation, and the upgrade 
installed the new version of file. 


file has changed types since its 
original installation, from typel to 
type2. For example, you may have 
changed an actual file to be a 
symbolic link. The upgrade 
changed file back to its original 


type, typel. 


Since the original installation, file 
was changed to be a symbolic link 
to target2 instead of target1. The 
upgrade changed file to point to its 
original target1. 


When originally installed, filel was 
a hard link to file2. At the time of 
the upgrade, filel was no longer a 
hard link to file2 . Upgrade restores 
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Recommended Action 


Determine whether the 

modifications made to file2 
should be made to the new 
version of the file, file1. | 


Determine whether the 
differences in the new 
version of file2 should be © 
incorporated into the 
preserved version of file1. 


Determine whether file 
should be deleted. 


Determine whether file” 
should be changed back to 


type2. 


Determine whether file 
should be changed to point 
to target2. 


Determine whether file1 
should be changed to what 
it was before the upgrade. 
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How to Upgrade Clients With Different Platforms and Platform Groups 


If you’ve upgraded a heterogeneous OS server, clients of that server are 
automatically upgraded only if their platform (SPARC, x86) and platform 
group (for example, sun4d, sun4L, i386) is supported by the Solaris CD. For 
example, if you upgrade a SPARC server using the SPARC Solaris CD, only 
SPARC clients that share the platform group on the CD are upgraded. 


To upgrade clients with different platforms and platform groups, you must use 
the server_upgrade command. See the server_upgrade man page or x86: 
Solaris 2.5 Installation Notes or the SPARC: Installing Solaris Software for more 
instructions. 
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Where to Go After Installing Solaris T= 


Table 11-1 shows the Solaris documentation that you may need after installing 
the Solaris software on a system. For a complete description of all the Solaris 
2.5 documentation, refer to the Solaris 2.5 Introduction. 


Note — Some SPARC systems require that you add additional software before 
Solaris software is completely installed. Check your hardware vendor 
documentation to see if your vendor requires any additional software to run 
Solaris. For instructions on adding software, see the Solstice AdminSuite 2.1 
User’s Guide. 


Table 11-1 Where to Go After Installing Solaris Software 


Information Needed Manual Title 
Adding and removing Solstice AdminSuite 2.1 User’s Guide 
Solaris, third-party, or 


unbundled software 


Setting up mail accounts Mail Administration Guide 
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Table 11-1 Where to Go After Installing Solaris Software (Continued) 


Information Needed Manual Title 


Installing software (for System Administration Guide, Volume I 

example AnswerBooks) 
Note: The End User AnswerBook is the only 
AnswerBook installed with the Solaris software; and 


only installed if the entire distribution software group 
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Setting up user accounts 
Halting a system 
Boot files 


Adding systems to a 
network 


Accessing remote files and 
systems 


Administering file systems 
Setting up system security 


CD-ROM and diskette 
drives 


Setting up printers 


Increasing your system’s 
performance 


Managing disk use 


Examining and changing 
system information 


Using crontabs 


is installed. 

System Administration Guide, Volume I 
System Administration Guide, Volume I 
System Administration Guide, Volume I 


System Administration Guide, Volume I 
System Administration Guide, Volume I 


System Administration Guide, Volume I 
System Administration Guide, Volume I 


System Administration Guide, Volume I 


System Administration Guide, Volume II 


System Administration Guide, Volume II 


System Administration Guide, Volume II 


System Administration Guide, Volume II 


System Administration Guide, Volume II 


SPARC: Installing Solaris Software—November 1995 


Table 11-1 Where to Go After Installing Solaris Software (Continued) 


Information Needed 


Adding and Maintaining 
Peripherals 


Accessing devices 
Setting up disks 


Terminals and modems, 
disk drives, tape drives, 
service access facility, 
connecting devices to serial 
port, format utility 


Using system 
administration tools 


Manual Title 


System Administration Guide, Volume II 


System Administration Guide, Volume II 
System Administration Guide, Volume II 


System Administration Guide, Volume II 


Solstice AdminSuite 2.1 User’s Guide 


Where to Go After Installing Solaris 


dd 
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Worksheets for the Solaris 
Installation Program A 


What's in the Worksheets 


The worksheets list information that may need to be supplied during the 
Solaris installation program. There are separate worksheets for the initial and 
upgrade options. 


How to Use the Worksheets 


The worksheets can be used before installing Solaris software, or to record 
your responses when you install Solaris software. For example, if you’re a 
system administrator of a large site and need to delegate the task of installing 
Solaris software to less-experienced staff, you can fill out the worksheet in 
advance; installers will know exactly how you want them to install Solaris 
software on their system, thus reducing the errors that come from guessing. 


Note — If you’re using the following worksheet to gather information before 
installing Solaris software, you can ignore shaded areas if you are installing a 
system as a standalone, non-networked system. 
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Worksheet for the Initial Installation Option 


The following worksheet lists important information you may need to supply 
when installing Solaris software on a system for the first time. 


Information You May Need 
When Installing Solaris Description/Example _ Work Space 


Host name Host name of the system. 
Example: sherlock 


s the system connected to a 


nternet protocol address of the 
system you're installing. 
Example: 129.221.2.1 


s the system a client of NIS+ or 
NIS? Part of another name 
service? Or is a name service not 
yet established? 
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Information You May Need 
When Installing Solaris Description/Example 


Name server information | Name server’s host name and IP 


_ Example: toucan, 125.221.2.1 
Is the system part of a subnet? 


: Netmask of the subnet. 
: a Example: 255.255.0.0 


Time zone Default time zone. Can be set by 
selecting geographic region, hours 
offset from GMT, or by pointing to 
a filein /usr/share/zoneinfo 
directory. 

Example: US/ Mountain 


System type System type: standalone system, 
OS server, or dataless client? 


All the platforms for clients that 
are different from the OS server’s 
platform (see Appendix C, 

‘Platform Names and Groups”). 


Number of clients the OS server 
will support. 
Example: 5 (default) 


Number of megabytes of swap, 


root, or both to assign clients. 
Example: 24 Mbytes (default) 


Worksheets for the Solaris Installation Program 


Work Space 
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A 


Information You May Need 
When Installing Solaris Description/Example 


Note: SunSoft plans to remove 
support for the dataless client 
system type after Solaris 2.5. You 
can select this system type now, 
but in future releases you will 
need to select a different type. 


Host names and IP addresses of 
the server(s) where dataless clients 
will mount their /usr file 


Languages  _ Language(s) to select for 
displaying the user interface after 
installing Solaris software. 
Example: French, Spanish 
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Work Space 


Information You May Need 
When Installing Solaris 


Software 


Disk(s) to install Solaris 
software on 


Auto-layout file systems? 


File systems to auto-layout 


Preserve existing data? 


Worksheets for the Solaris Installation Program 


Description/Example Work Space 


Which software group to install? 
¢ Core 
e End user system support 
e Developer system support 
e Entire distribution 
e Entire distribution plus OEM 
support 


Should the software group be 
customized? 


Note: Removing or adding 


software often creates software 
dependencies; system 
administration knowledge is often 
required to fix dependencies. 


Disk(s) for installing Solaris. _ 
Example: cOt0d0, cOt3d0, cOt4d1 


Should file systems be laid out on 
disks automatically or manually? 


Note: Manual layout requires 
advanced system administration 


skills. 


Which file systems should be used 
for auto-layout? 
Example: /, /opt, /var 


_ Should existing data on disk(s) be 


preserved? 
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Information You May Need 
When Installing Solaris Description/Example 


Disk slices to preserve data Which slices should be preserved? 
Example: /opt on c0t2d2 


File system and disk layout Accept the layout of file systems 
as created by auto-layout or 
manual layout, or customize? 


Note: Customizing requires 
advanced system administration 


skills. 


Mount remote file systems from a 
server? 


Provide remote file system 
information: 

¢ Local mount point 

e Server’s host name 
Server’s IP address 
File system path 


Example: 

Server: mitra 

Server IP address: 129.222.2.2 
File system path: /export/home 
Local mount point: /export 


Reboot Reboot after installing Solaris? 


Root password Create root password. 
Example: catéfile 
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Work Space 


Worksheet for the Upgrade Option 


The following worksheet lists the important information you may need to 


supply when upgrading a system from Solaris 2.1 or later. 


_ Information You May Need 
When Upgrading Solaris Description/Example 


Host name Host name of the system 
Example: sherlock 


Network connectivity Is the system connected to a 
network? 


2 Primary network interface for 
_the system. 
Example: le0 


Internet protocol address of the 
system you're installing. 
Example: 129.221.2.1 


Is the system a client of NIS+ or 
NIS? Part of another name 
service? Or is a name service 
“not yet established? 

Example: Other, DCE 


~Domain in which the system 
resides. — 
Example: chandon 


Worksheets for the Solaris Installation Program 


Work Space 
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Information You May Need | 
When Upgrading Solaris Description/Example 


: Specify a name server for the 
system, or have software try to 
find one? 


Name server’s host name and IP 
_address. 
Example: toucan, 125.221.2.1 


s the system part of a subnet? 


Netmask of the subnet. 
Example: 255.255.0.0 


Time zone Default time zone. Can be set by 
selecting geographic region, 
hours offset from GMT, or by 
pointing to a file in 
/usr/share/zoneinfo 
directory. 

Example: US/ Mountain 


Installing Solaris - upgrade Choose the upgrade or initial 

or initial? option for installing Solaris. 

Disks to upgrade Select a disk to use for 
upgrading to new version of 
Solaris. : 


Example: c0d0t0 
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Work Space 


Information You May Need 
When Upgrading Solaris 


Languages 


Customizing software? 


Description/Example 


Language(s) to select for 
displaying the user interface 


after installing Solaris software. 


Example: French, Spanish 


Do you want to customize 
software before starting the 


upgrade? 


Note: Removing or adding 
software often creates software 
dependencies; system 


_ administration knowledge is 


often required to fix 


dependencies. 


Worksheets for the Solaris Installation Program 


Work Space 
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System Identification Label B 


For your convenience, the following pages contain system identification labels 
(a sample, and one for photocopying). Attach them to systems at your site so 
users have access to information needed to install Solaris software and operate 
their system. 
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Sample - System Identification Label 


As shown in the following sample, system identification labels can provide a 


quick reference to important system information. 


Host name: roylat 


Boot command 


System type 


Platform name 
Terminal type 


Networked? 


Primary network interface 
IP address 

Name service 

Domain name 

Name server and IP address 
System part of a subnet? 
Netmask 


Ethernet address 
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boot sd(0,6,2) 


vu Standalone system 
i 
CO 
C 
[i 


OS server 
Diskless client 
Dataless client 


AutoClient system 


sun4c. 


SPARCstationIPC 


Yes. 


Yes. 


8:0:20:b:40:e7, 
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System Identification Label 


Photocopying the following label and identifying system information for each 
system provides a quick reference for users. 


Host name: 


System type 
Standalone system 


OS server 
Diskless client 


Dataless client 


es eae eat Se 


AutoClient system 


Terminaltype 


Networked? 


Primary network interac 
I 


Et h e r n et ad d ress ea AANA SISA IP AUER SMT ARCO CE EROS SOLICUSICSES OME SLSEUMEREEETMEOEACEC MOONEE SINESRAAEOMESSEDEALNEMSERLSEEO OILED HACOONINES EOMECEE ASCO US EOOMIESBERSSUEEN IMCL ES NSS 
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Platform Names and Groups 


C 


Table C-1 shows the platform names of various hardware platforms. You may 
need this information when preparing a system to install Solaris software. 


Use uname -i to determine a system's platform name; use uname -m to 
determine a system’s platform group. 


Table C-1 Platform Names and Groups 


System 
x86 


SPARCstation 1 
SPARCstation1+ 
SPARCstation SLC 
SPARCstation ELC 
SPARCstation IPC 
SPARCstation IPX 
SPARCstation 2 


SPARCcenter 1000 
SPARCcenter 2000 


Platform Name 


i86pc 


SUNW,Sun_4_60 
SUNW;Sun_4_65 
SUNW,Sun_4_20 
SUNW,Sun_4_25 
SUNW;Sun_4_40 


SUNW,Sun_4_50 


SUNW,Sun_4_75 


SUNW,SPARCserver-1000 
SUNW,SPARCcenter-2000 


Platform Group 
i86pc 


sun4c 
sun4c 
sun4c 
sun4c 
sun4c 
sun4c 


sun4c 


sun4d 


sun4d 
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Table C-1 Platform Names and Groups 


System 
SPARCstation 5 
SPARCstation 10 
SPARCstation 10SX 
SPARCstation 20 
SPARCserver6xx 
SPARCstation LX 
SPARCstation LX+ 
SPARCclassic 
SPARCclassic X 
SPARCengine EC3 
SPARCstation Voyager 


Sun Ultra 1 Model 140 
Other SPARC systems 


Platform Name 
SUNW,SPARCstation-5 
SUNW,SPARCstation-10 


~ SUNW,SPARCstation-10,SX 


SUNW,SPARCstation-20 
SUNW,SPARCsystem-600 
SUNW,SPARCstation-LX 
SUNW,SPARCstation-LX+ 
SUNW,SPARC classic 
SUNW,SPARCclassic-X 
SUNW,SPARCengine-EC-3 
SUNW,S240 


SUNW ,Ultra1-140 


See your hardware vendor 
documentation for platform 
name information. 
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Platform Group 
sun4m 
sun4m 
sun4m 
sun4m | 
sun4m 
sun4m 
sun4m 
sun4dm 
sun4m 
sun4m 


sun4m 


sun4u 


Sample Custom JumpStart 


Installation | — 


This example shows a set of steps a system administrator would take to do a 
custom JumpStart installation for a fictitious site. 


Sample Site Setup 


Figure D-1 shows the sample site setup for this example. 


\ server_1 = install/boot server 


we 


es, 


Figure D-1 Sample Site Setup 
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At this fictitious site: 


¢ The engineering group is on its own subnet. This group uses 32-Mbyte Sun 
IPX systems for software development. 


¢ The marketing group is on its own subnet. This group uses 16-Mbyte Sun 
ELC systems for running word processing, spreadsheets, and other office 
tools. : 


© The site uses NIS+. The Ethernet addresses, IP addresses, and host names 
are in NIS+ tables. 


° The engineering server named server_1 has a copy of Solaris 2.4 software 
on its local disk in a directory named /export/install. Both the 
engineering and marketing groups will install Solaris software over the 
network from server_1. 


Create a JumpStart directory. 


The administrator sets up a JumpStart directory on the install server, 
server_1. This directory will hold files necessary for a custom JumpStart 
installation of Solaris software. The easiest way to set up this directory is to 
copy the sample directory from the copy of the Solaris CD that has been put in 
/export/install. 


# cp -r /export/install/auto_install_sample /jumpstart 
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2 Share the JumpStart directory. 


The system administrator shares the /jumpstart directory so that the rules 
file and profiles are accessible to systems on the network. To accomplish this, 
the administrator adds the following line to the /etc/dfs/dfstab file: 


share -F nfs -o ro,anon=0 /jumpstart 


Then, at the command line, the administrator uses the unshareall and 
shareall commands: 


# unshareall 


# ghareall 


3 Create the eng_profile profile. 


The administrator creates a file named eng_profile in the /jumpstart 
directory. The eng_profile file has the following entries, which define the 
Solaris software to be installed on systems in the engineering group. 


install type initial_install 
system_type standalone 
partitioning default 


cluster SUNWCprog 
filesys any 5O swap 


0 Specifies that the installation will be treated as an initial installation, as 
opposed to an upgrade. 


®@ Specifies that the engineering systems are standalone systems. 


® Specifies that the JumpStart software uses default disk partitioning for 
installing Solaris software on the engineering systems. 


© Specifies that the developer’s software cluster will be installed. 


® Specifies that each system in the engineering group will have 50 Mbytes of 
swap space. 
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Create the marketing_profile profile. 


The administrator creates a file named marketing_profile in the 
/jumpstart directory. The marketing_profile file has the following 
entries, which define the Solaris software to be installed on systems in the 
marketing group. 


install_type initial_install 
system_type standalone 
partitioning default 


cluster SUNWCuser © 
package SUNWaudmo 


@ Specifies that the installation will be treated as an initial installation, as 
opposed to an upgrade. 


® Specifies that the marketing systems are standalone systems. 


© Specifies that the JumpStart software will use default disk parnvonine: —— 
installing Solaris software on the marketing systems. 


© Specifies that the end user software cluster is to be installed. 


® Specifies that the audio demo software package is to be added to each 
system. 


Edit the rules file. 


The administrator must define the rules file. The Solaris installation program 
will use the contents of this file to select the proper installation for each 
department. 


At this site, each department is on its own subnet and network address. The 
administrator uses this information to control how systems are installed. The 
engineering department is on subnet 255.222.43.0, and marketing is on 
255.222.44.0. 


In the /jumpstart directory, the administrator edits the rules file, deletes all 
of the example rules, and enters: 


network 255.222.43.0 - eng_profile ~ 


network 255.222.44.0 - marketing_profile - 
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Note — These are sample rules in which an administrator uses a network 
address to identify which systems will be installed with the eng_profile and 
marketing_profile, respectively. The administrator could also have chosen 
to use host names, memory size, or model type as the rule keyword. See “Rule 
Keyword and Rule Value Descriptions” on page 88 for a complete list of 
keywords you can use in a rules file. 


Execute the check script. 


After the rules and profile files are properly set up, the system.administrator 
runs the check script to verify the files. 


# cd /jumpstart 


# ./check 


When check finds no errors, it creates the rules. ok file. 
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7 Set up the engineering systems for installation. 


After setting up the /jumpstart directory and appropriate files, the 
administrator sets up the install server to install Solaris software on the 
engineering systems. 


The administrator first sets up the engineering systems because they are on the 
same subnet as the install server. On the install server, the administrator uses 
the add_install_client command: 


# cd /export/install 
# ./add_install_ client -c server_1:/jumpstart host_engl sun4c 
# ./add_install_client -c server_1:/jumpstart host_eng2 sun4c 


In the add_install_client command, 


-c Specifies the server (server_1) and path 
(/jumpstart) to the JumpStart directory. 


host_eng1 Is the name of a system in the engineering group. 

host_eng2 Is the name of another system in the engineering 
group. 

sun4c Specifies the platform of the systems that will use 


server_1 as an install server. (This is the proper 
platform name for Sun IPX systems.) 
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8 Sef up the marketing systems for installation. 


Systems cannot boot from an install server on a different subnet, so the 
administrator sets up a boot server on the marketing group’s subnet. On a 
server on the marketing subnet, the administrator inserts a Solaris CD. The 
administrator then uses the setup_install_server command to copy the 
boot software from the CD to the marketing server. 


# ed /cdrom/cdrom0/s0 


# ./setup_install_ server -b /marketing/boot-dir sun4c 


In the setup_install_server command, 


=b Specifies that setup_install_server will copy 
the boot information from the Solaris CD to the 
directory named /marketing/boot-dir. 


sun4c Specifies the platform of the systems that will use 
this boot server. (This is the proper platform name 
for Sun ELC systems.) 


Next, the administrator sets up the marketing systems to boot from the local 
boot server and install Solaris from the remote install server. The administrator 
uses the add_install_client command on the marketing group’s boot 
server: 


# cd /marketing/boot-dir 
# ./add_install_client -s server_1:/export/install -c server_1:/jumpstart host_mkt1 sun4c 
# ./add_install_client -s server_1:/export/install -c server_1:/jumpstart host_mkt2 sun4c 


In the add_install_client command, 


-s Specifies the install server (server_1) and the 
path to the Solaris software (/export/instal1l). 
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host_mktl 


host_mkt2 


sun4c 


Specifies the server (server_1) and path 
(/jumpstart) to the JumpStart directory. 


Is the name of a system in the marketing group. 


Is the name of another system in the marketing 
group. | 
Specifies the platform of the systems that will use 


this boot server. (This is the proper platform name 
for Sun ELC systems.) 


9 Boot the systems and install Solaris software. 


The administrator boots the engineering systems by using the following boot 
command at the ok (PROM) prompt of each system. 


ok boot net - install 
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Troubleshooting E 


This appendix describes problems you may encounter when installing Solaris 
software, and suggests possible solutions. 


The following table shows common error messages and the page number 
where you can find causes and possible solutions. 


Po ee ee ee ee ee ree a 


| Error: Unknown client “host_name” page 170 | 


ee ee a neni iit Seer 


| No network boot server. Unable to install the system. See installation page 170 
_ instructions. 


| pkgrm: ERROR: class action script did not complete successfully.Removal page 171 
of <SUNWuodte> failed. | 


WARNING: clock gained xxx days -- CHECK AND RESET DATE! page 172 
| WARNING: getfile: RPC failed: error 5 (RPC Timed out). page 173 


169 


E 


Specific Installation Errors 


Error: Unknown client “host_name” 


Reason Error Occurred ' How to Fix the Problem 
The host_name argument in the Add the host host_name to the NIS or NIS+ name service. (Either update the 
add_install_client command must  NIS maps or populate the NIS+ tables.) Try executing the 
be a host in the name service. add_install_client command again. 
leQ: No carrier - transceiver cable problem 
Reason Error Occurred How to Fix the Problem 
This system is not connected to the If this is a non-networked system, ignore this message. If this is a networked 
network. system, make sure the Ethernet cabling is attached securely. 


No network boot server. Unable to install the system. 


See installation instructions. 


Reason Error Occurred How to Fix the Problem 

This error occurs on a system that you The system administrator must set up an install server to be used for custom 
are attempting to install using custom JumpStart installation (see Creating an Install Server on page 22). Otherwise, 
JumpStart. The system could not find a you must do an interactive installation, as documented in Chapter 8, 


local Solaris CD or an install server on “Booting and Installing Solaris: Interactive.” 
the network. | | 
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| pkgrm: ERROR: class action script did not complete successfully.Removal of 
<SUNWuodte> failed. 


Reason Error Occurred How to Fix the Problem 


Problem in Solaris 2.4 and early 2.5 with Ignore the message. 
building the package. 


prom_panic: Could not mount filesystem 


Reason Error Occurred How to Fix the Problem 


This error occurs when you are doing a Make sure that the installation software is mounted and shared. 

network installation, but the boot If installing from the install server’s CD-ROM drive, make sure the Solaris 
software cannot locate the Solaris CD is inserted in the CD-ROM drive, is mounted, and shared in the 
installation image (either the Solaris CD  /etc/dfs/dfstab file. If installing from a copy of the Solaris CD on the 
or a copy of the Solaris CD on the install install server’s disk, make sure the directory path to the copy is shared in 
server). the /etc/dfs/dfstab file. 


boot: cannot open /kernel/unix 


Reason Error Occurred How to Fix the Problem 


This error occurs when you override the Reset the boot file in the PROM to “ “ (nothing). 
boot file location by explicitly setting it to 7 

/kernel/unix. In Solaris 2.5, the kernel 

no longer resides in /kernel /unix, but 

in /platform/<arch>/kernel/unix. 


The file just loaded does not appear to be executable 
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Reason Error Occurred | How to Fix the Problem 

This message cannot find the proper Verify that you are using the correct boot command for your system. If 
media for booting. installing from a CD-ROM drive, make sure the Solaris CD is in the 


CD-ROM drive and that the CD-ROM drive is mounted. See the table for 
boot commands on page 128. 


Timeout waiting for ARP/RARP packet... 


Reason Error Occurred How to Fix the Problem 

The client is trying to boot over the Verify the system’s host name is in the NIS or NIS+ name service. Also, 
network, but it cannot find asystem that verify the bootparams search order in the /etc/nsswitch.conf file. For 
knows about it. example, the following line in the /etc/nsswitch.conf file indicates the 


software will first look in the NIS maps for bootparams information. If not 
found there, software will look in the /etc/bootparans file. 


bootparams: nis files 


WARNING: clock gained xxx days -- CHECK AND RESET DATE! 
Reason Error Occurred How to Fix the Problem 
This is an informational message. Ignore the message and continue with the installation. 
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WARNING: getfile: RPC failed: error 5 (RPC Timed out). 


Reason Error Occurred 


This error occurs when you have two or 
more servers on a network responding to 
an install client’s boot request. The install 
client connects to the wrong boot server, 
and the installation hangs. The following 
specific problems may cause this error: 


e There may be /etc/bootparams files 
on different servers with an entry for 
this install client. 


e There may be multiple /tftpboot or 
/cplpboot directory entries for this 
install client. 


e There may be an install client entry in 
the /etc/bootparams file on a server 
and an entry in another 
/etc/bootparams file enabling all 
systems to access the profile server. 
Such an entry would look like this: 

* install_config=profile_server :path 


A line like this in the NIS or NIS+ 
bootparams table would also cause this 
error. 


How to Fix the Problem 


Examine the network setup: 


e Ensure that servers on the network do not have multiple | 
/etc/bootparams entries for the install client. If they do, remove 
duplicate client entries in the /etc/bootparanms file on all install and 
boot servers except the one you want the install client to use. 


e Ensure that servers on the network do not have multiple /t£tpboot or 
/cplboot directory entries for the install client. If they do, remove 
duplicate client entries from the /t£tpboot or /rplboot directories on 
all install and boot servers except the one you want the install client to use. 


e If there’s a wildcard entry in the name service bootparams map or table 
(for example, * install_config-), delete it and add it to the 
/etc/bootparams file on the boot server. 
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General Installation Problems 


Problem 


The system boots over the network, but 
from a system other than the specified 
install server. 


Problem 


After you set up an install server and 
configure the system to install over the 
network, the system still does not boot. 


How to Fix the Problem 


On the name server, update the /etc/bootparams entry for the system 
being installed. The entry should conform to the following syntax: 


install_system root=boot_server:path install-=install_server : path 


Also, ensure there is only one bootparams entry on the subnet for the 
install client. 


How to Fix the Problem 


Be sure the tftpd daemon is running on the install server. Type the 
following command and press Return: 


ps -ef | grep tftpd. 
If this command does not return a line indicating the t £tpd daemon is 
running, edit the /etc/inetd.conf file and remove the comment (#) 


character from the following line: 


#tftp dgram udp wait root/usr/sbin/in.tftpd in.tftpd -s 
/tfitpboot 


After making this change, try booting the system again. 
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OpenWindows is not available to 
diskless and dataless clients. 


rH 
i 


How to Fix the Problem 


The /usr/openwin may be on a separate, mounted file system. This 
directory is not automatically shared by admintool. 

The /usr/openwin file system must be manually added to the server’s 
/etc/dfs/dfstab file and the file system must be shared. The entry looks 
like this: 


share -F nfs /usr/openwin 


Also, an explicit mount of the file system must be made in the client’s 
/etc/vfstab file using the following: 


server_name:/usr/openwin - /usr/openwin nfs - yes - 


Troubleshooting | 175 


HHI 
rm 


Problem | How to Fix the Problem 


Several processes that normally run To boot from the CD to do disaster recovery (that is, restoring the root file 
when booting the system are not run system), you need to add functionality normally provided when booting. To 
when the system boots from the provide this functionality, a script is provided, /sbin/setup_cd, which 


CD. (This is done to enable the system to _can be run to perform the additional setup that might be needed to do 
boot and the Solaris installation program disaster recovery. setup_cd does the following tasks: 
to run with only 16 Mbytes of memory.) 

~ Finishes setting up the device file system for tapes and ports 

— Enables routing 

~ Enables multicast 

— Invokes the statd(1M) daemon 

— Invokes the Llockd(1M) daemon 

— Starts the automounter 


Note that if setup_cd is run on a 16 Mbyte system, it may not be possible 
to run suninstall or other programs that need more memory. If a disk 
with a swap partition is available, the system administrator could avoid this 


problem by using the swap (1M) command to add swap space to the system 
before invoking setup_cd. 


When booting from the CD during disaster recovery, it is possible to boot the 
system in single user mode from the CD. For example: 


boot cdrom -s 


Problem How to Fix the Problem 

An installation using the upgrade option 1. Reboot the system from the Solaris CD or from the network. 

fails for reasons beyond your control, 2. Choose the upgrade option for installation. 

such as a power failure or a network The Solaris installation program will determine if the system has been 
connection failure. The system may be in partially upgraded and will continue the upgrade. 


an unbootable state. 
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Time Zones F 


The next page shows time zones of the world by hours offset from Greenwich 
Meantime. This may be useful when setting a system’s clock during the Solaris 
installation program. 


Figure F-1 reflects Standard Time. If daylight saving time is in effect, add one 
hour. 
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q_ Earlier | Later 


-11 -10 9 -8 -7 6 -5 4 -3 -2 -thr O +thr +2 +3 +4 +5 #+6 «+7 «+8 «+49 «+10 411 412 


-11 -10 9 -8 -7 46 - 3 -2 -ihr O +thr +2 +38 +4 +5 46 #4+7 «#48 «#449 «+410 411 412 


Figure F-1 Greenwich Meantime Map 
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AutoClient system 


begin script 


boot server 


client 


cluster 


Glossary G 


A system type that caches all of its needed system software from an OS server. 
Because it contains no permanent data, an AutoClient is a field replaceable unit 
(FRU). It requires a small local disk for swapping and for caching its individual 
root (/) and /usr file systems from an OS server. 


A user-defined Bourne shell script, specified within the rules file, that 
performs tasks before the Solaris software is installed on the system. Begin 
scripts can be used only with custom JumpStart installations. 


A server that provides boot services to systems on the same subnet. A boot 
server is required if the install server is on a different subnet than the systems 
that need to install the Solaris software from it. 


A system connected to a network. 


A logical grouping of software packages. The Solaris software is divided into 
four main software groups, which are each composed of clusters and packages. 
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core 


custom JumpStart installation 


dataless client 


derived profile 


developer system support 


disk configuration file 


diskless client 


domain 
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A software group that contains the minimum software required to boot and 
run the Solaris operating environment on a system. It includes some 
networking software and the drivers required to run the OpenWindows 
environment; it does not include the OpenWindows software. 


A type of installation in which the Solaris software is automatically installed 
on a system based on a user-defined profile. You can create customized profiles 
for different types of users. 


A networked system that has its own disk on which it maintains its own root 
(/) file system and swap space. However, a dataless client relies on an OS 
server for its /usr system. | 


A profile that is dynamically created by a begin script during a custom 
JumpStart installation. 


A software group that contains the End User System Support software group 
plus the libraries, include files, man pages, and programming tools for 
developing software. 


A file that represents a structure of a disk (for example, bytes/sector, flags, 
slices). Disk configuration files enable you to use pfinstall from a single 
system to test profiles on different sized disks. 


A networked system that does not have its own disk, so it relies completely on 
an OS server for software and file storage. Diskless clients do not have to use 
the Solaris installation program, because they use the software that is already 
installed on an OS server. 


A part of the Internet naming hierarchy. It represents a group of systems on a 
local network that share administrative files. 
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domain name 


end user system support 


entire distribution 


G 


The identification of a group of systems on a local network. A domain name 
consists of a sequence of component names separated by periods (for example: 
tundra.mpk.ca.us). As you read a domain name from left to right, the 
component names identify more general (and usually remote) areas of 
administrative authority. 


A software group that contains the core software group plus the recommended 
software for an end user, including OpenWindows and DeskSet software. 


A software group that contains the entire Solaris release. 


entire distribution plus OEM support 


/etc 


/export 


fdisk partition 


file server 


A software group that contains the entire Solaris release, plus additional 
hardware support for OEMs. This software group is recommended when 
instaling Solaris software on servers. 


A directory that contains critical system configuration files and maintenance 
commands. 


A file system on an OS server that is shared with other systems on a network. 
For example, the /export file system can contain the root file system and 
swap for diskless clients and the home directories for users on the network. 
Diskless clients rely on the /export file system on an OS server to boot and 
run. 


A logical partition of a disk drive dedicated to a particular operating system on 
x86 systems. During the Solaris installation program, you must set up at least 
one Solaris fdisk partition on an x86 system. x86 systems are designed to 
support up to four different operating systems on each drive; each operating 
system must reside on a unique fdisk partition. 


A server that provides the software and file storage for systems on a network. 
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file system 


finish script 


host name 


initial installation option 


install server 


interactive installation 
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A collection of files and directories that, when set into a logical hierarchy, make 
up an organized, structured set of information. File systems can be mounted 
from your local system or a remote system. 


A user-defined Bourne shell script, specified within the rules file, that 
performs tasks after the Solaris software is installed on the system, but before 
the system reboots. Finish scripts can be used only with custom JumpStart 
installations. | | 


The name by which a system is known to other systems on a network. This 
name must be unique among all the systems within a given domain (usually, 
this means within any single organization). A host name can be any 
combination of letters, numbers, and minus sign (-), but it cannot begin or end 
with a minus sign. 


An option presented during the Solaris installation program that overwrites 
the disk(s) with the new version of Solaris. The initial installation option is 
presented for upgradable systems; however, the disk(s) that contain the old 
version of Solaris software (including the local modifications) will be 
overwritten if you choose the initial installation option. 


A server that provides the Solaris installation image for other systems on a 
network to boot and install from (also known as a media server). The Solaris 
installation image can reside on the install server’s CD-ROM drive or hard 
disk. 


A type of installation where you have full hands-on interaction with the Solaris 
installation program to install the Solaris software on a system. 
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IP address 


JumpStart directory 


JumpStart installation 


locale 


media server 


mount 


mount point 


hame server 


G 


Internet protocol address. A unique number that identifies a networked system 
so it can communicate via Internet protocols. It consists of four numbers 
separated by periods. Most often, each part of the IP address is a number 
between 0 and 225; however, the first number must be less than 224 and the 
last number cannot be 0. 


IP addresses are logically divided into two parts: the network (similar to a 
telephone area code), and the system on the network (similar to a phone 
number). 


When using a diskette for custom JumpStart installations, the JumpStart 
directory is the root directory on the diskette that contains all the essential 
custom JumpStart files. When using a server for custom JumpStart 
installations, the JumpStart directory is a directory on the server that contains 
all the essential custom JumpStart files. 


A type of installation in which the Solaris software is automatically installed on 
a system by using factory-installed JumpStart software. 


A specific language associated with a region or territory. 
See install server. 


The process of making a remote or local file system accessible by executing the 
mount command. To mount a file system, you need a mount point on the local 
system and the name of the file system to be mounted (for example, /usr). 


A directory on a system where you can mount a file system that exists on the 
local or a remote system. 


A server that provides a name service to systems on a network. 
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name service | 
A distributed network database that contains key system information about all 
the systems on a network, so the systems can communicate with each other. 
With a name service, the system information can be maintained, managed, and 
accessed on a network-wide basis. Sun supports the following name services: 
NIS (formerly YP) and NIS+. Without a name service, each system has to 
maintain its own copy of the system information (in the local /etc files). 


network installation 


A way to install software over the network—from a system with a CD-ROM 
drive to a system without a CD-ROM drive. Network installations require a 
name server and an install server. 


networked systems | 
A group of systems (called hosts) connected through hardware and software, 
so they can communicate and share information; referred to as a local area 
network (LAN). One or more servers are usually needed when systems are 


networked. 

NIS | 
Network Information Service. A type of name service that is standard on — 
SunOS 3.x, 4.x, and Solaris 1.x systems. 

NIS+ 


Network Information Service, Plus. The replacement for NIS that provides 
automatic information updating and adds security features such as 
authorization and authentication. NIS+ is the standard on Solaris 2.x systems. 


non-networked systems 
Systems that are not connected to a network or do not rely on other systems. 


/opt | 
A file system that contains the mount points for third-party and unbundled 
software. 


OS server 7 
A system that provides services to systems on a network. To serve diskless 
clients, an OS server must have disk space set aside for each diskless client’s 
root file system and swap space (/export/root, /export/swap). To serve 
dataless clients, an OS server must provide the /usr file system. To serve 
autoclients, an OS server must provide everything except the individual root 
(/) and /usr file systems required for swapping and caching. 
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package 


platform group 


platform name 


profile 


/ (root) 


rule 


rules file 


rules.ok file 


slice 


G 


A functional grouping of files and directories that form a software application. 
The Solaris software is divided into four main software groups, which are each 
composed of clusters and packages. 


A vendor-defined grouping of hardware platforms for the purpose of 
distributing specific software. Examples of valid platform names are i86pc, 
sunAc. 


The output of the uname -i command. For example, the platform name for 
the SPARCstation IPX is SUNW,Sun_4_50. 


A text file used as a template by the custom JumpStart installation software. It 
defines how to install the Solaris software on a system (for example, initial 
installation or upgrade option, system type, disk partitioning, software group), 
and it is named in the rules file. See rules file. 


The file system at the top of the hierarchical file tree on a system. The root 
directory contains the directories and files critical for system operation, such as 
the kernel, device drivers, and the programs used to start (boot) a system. 


A series of values that assigns one or more system attributes to a profile. 


A text file used to create the rules.ok file. The rules file is a look-up table 
consisting of one or more rules that define matches between system attributes 
and profiles. See profile. 


A generated version of the rules file. It is required by the custom JumpStart 
installation software to match a system to a profile. You must use the check 
script to create the rules.ok file. 


An area on a disk composed of a single range of contiguous blocks. A slice is a 
physical subset of a disk (except for slice 2, which by convention represents the 
entire disk). A disk can be divided into eight slices. Before you can create a file 
system on a disk, you must format it into slices. 
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Solaris installation program 


software group 


standalone system 


subnet 


subnet mask 


swap space 


system types 


time zone 
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(1) A menu-driven, interactive program that enables you to set up a system 
and install the Solaris software on it. (2) Any part of the software that is used 
to install the Solaris software on a system. 


A logical grouping of the Solaris software (clusters and packages). During a 
Solaris installation, you can install one of the following software groups: core, 
end user system software, developer system support, or entire distribution. 


A system that has its own root (/) file system, swap space, and /usr file 
system, which reside on its local disk(s); it does not require boot or software 
services from an OS server. A standalone system can be connected to a 
network. 


A working scheme that divides a single logical network into smaller physical 
networks to simplify routing. 


A bit mask, which is 32 bits long, used to determine important network or 


system information from an IP address. 


Disk space used for virtual memory storage when the system does not have 
enough system memory to handle current processes. Also known as the /swap 
or swap file system. 


The different ways a system can be set up to run the Solaris software. Valid 
system types are: standalone system, dataless client, and diskless client, 
AutoClient system, OS server. However, the only system types that are covered 
in this document are standalone system, dataless client, and OS server. 


Any of the 24 longitudinal divisions of the earth’s surface for which a standard 
time is kept. 
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upgrade option 


/usr 


/var 


Volume Management 


G 


An option presented during the Solaris installation program. The upgrade 
procedure merges the new version of Solaris with existing files on your disk(s), 
and it saves as many local modifications as possible since the last time Solaris 
was installed. 


A file system on a standalone system or server that contains many of the 
standard UNIX programs. A dataless client must share (mount) /usr from a 
file server; it does not have its own /usr file system. Sharing the large /usr 
file system with a server rather than maintaining a local copy minimizes the 
overall disk space required to install and run the Solaris software on a system. 


A file system or directory (on standalone systems) containing system files that 
are likely to change or grow over the life of the system. These include system 
logs, vi files, mail files, and uucp files. 


A program that provides a mechanism to administer and obtain access to the 
data on CD-ROMs and diskettes. 
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Index 


Symbols 
- (minus sign) 
in begin and finish scripts 111 
in rules 87 
! (exclamation mark) rule field 84 
# (pound sign) 
in profiles 68 
in rules 87 
&& (ampersands) rule field 84 
... (ellipsis points) rule field 84 
= (equals sign) in profile field 98 
> prompt, changing to ok prompt 127, 133 
[] (brackets) rule field 84 
\ (backslash) in rules 87 


Numerics 


386 system, See x86 systems 
486 systems, See x86 systems 


A 


/a/var/sadm/install_ 
data/upgrade_cleanyup file 
137-138 | 

/a/var/sadm/install_ 
data/upgrade_log file 137 


access to JumpStart directory, enabling 49, 
65-67 
add_install_client command 
custom JumpStart example 166, 167- 
168 
example 38-39 
install server setup 37-39 
JumpStart directory access 65, 67 
syntax 38 
adding 
See also creating 
clusters when upgrading 73 
dataless clients for network 
installation 31-33, 36-37 
files with finish scripts 101 
install server configuration 
information 37-39 
locale.org_dir table entries 44 
OS servers for network installation 
31-33, 35, 37 
packages from software groups 80 
peripheral devices after installation 
143 
profile keywords to profiles 68 
rules to rules file 83-84 
software after installation 141 
standalone systems for network 
installation 31-34, 37 
systems to network 142 
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addresses, specifying 21 
administering file systems 142 
all 
location value for fdisk 74 
size value for fdisk 75 
size value for filesys 77 
alternative installation programs 111 
ampersands (&&) rule field 84 
AND rule field 84 
angle bracket (>) prompt, changing to ok 
prompt 127, 133 
AnswerBooks, installing 142 
any 
rule keyword 
description and values 88 
example 86 
rootdisk matching 92 
slice value for filesys 77 
arch rule keyword 88 
architecture, See platforms 
auto size value for filesys 77 
auto_install_samp1le directory 
check script 94 
copying files to JumpStart directory 
58, 62, 64 
set_root_pw finish script 102-104 
AutoClient systems 
custom JumpStart installation 
completion 136 
described 7 
identification labels 
SPARC systems 155-157 
x86 systems 155—?? 
interactive installation completion 
130 
Solaris already installed on OS server 
8 
auto-install, See custom JumpStart 
installation 
automounted file system symbolic links, 
preserving 116 


B 
-b option of setup_install_server 
command 29, 167 
backing up 
before installing Solaris 11 
before upgrading 115 


backslash (\) in rules 87 
banner command 21 
begin rule field 
described 85 
valid entries 87 
validation 93 
begin scripts _ 
creating derived profiles with 98-99 
overview 98 
permissions 98 
rule field 85 
site-specific installation programs 111 
begin.1log file 98 
binary compatibility package profile 
example 71 
boot diskette, See Solaris boot diskette 
boot server 
creating on subnet 27-29 
described 18 
requirement for network installation 
18-19, 22 
specifying for network installation 
OS servers 35 
standalone systems 34 
boot: cannot open /kernel/unix 
| message 171 
booting the system 
boot file documentation 142 
custom JumpStart installation 133- 
135 
I/O interrupt error messages 21 
interactive installation 127-128 
JumpStart installation 123 
resetting terminals and display first 
21 
troubleshooting 
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boot: cannot open 
/kernel/unix message 
171 
disaster recovery when booting 
from CD 176 
file just loaded does not 
appear to be 
executable message 
171-172 
general installation problems 174, 
176 
rebooting after failed upgrade 
176 
Timeout waiting for 
ARP/RARP packet 
message 172 
WARNING: getfile: RPC 
Eat Leds er ror.52 RPC 
Timed out message 66, 
173 
wrong server boots 174 
upgrade installation and boot file 
location 115, 171 
bootparanms file 
enabling JumpStart directory access 
66 
updating 174 
Bourne shell scripts in rule fields 85 
See also begin scripts; finish scripts 
brackets [] rule field 84 


buses supported 9 


C 


C locale name 44 

-c option | 
add_install_client command 38, 

166, 168 

pfinstall command 106 

caddy (CD-ROM), using 
custom JumpStart installation 132 
interactive installation 126 
JumpStart installation 122 


cannot open /kernel/unix message 
171 


Index 


case of profile keywords and values 68 


cat command 
multiple disk configuration file 
creation 
SPARC systems 109-111 
cd command, See changing directories 
CD, See Solaris CD 
CD-ROM drives 
booting from 128, 134 
documentation 142 
installation on systems without CD- 
ROM drives 17-18 
requirement for Solaris installation 9 
troubleshooting 
disaster recovery when booting 
from CD 176 
file just loaded does not 
appear to be 
executable message 
171-172 
No network boot server 
message 170 
prom panies: Could not 
mount filesystem 
message 171 
using 
custom JumpStart installation 
132 
interactive installation 126 
JumpStart installation 122 


changing directories 
to JumpStart directory 94 
to mounted CD 62, 64 
to Solaris CD image on local disk 57, 
61, 64 
check script 
comments and 87 
derived profiles and 99 
directory for 94 
rules file validation 49, 93-95 
custom JumpStart example 165 
derived profiles and 99 
rules.ok file creation 93 
testing rules 94 


Chinese locale value 79 
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class action script did not 
complete successfully 
message 171 
client_arch profile keyword 72 
client_root profile keyword 72 
client_swap profile keyword 72 
clients, dataless or diskless, See dataless 
clients; diskless clients 
clock gained xxx days message 172 
clock, time zones for setting 177-178 
cluster profile keyword 
description and values 73 
examples 69-71 
commands for network installation 21 
comments 
in profiles 68 
in rules file 87 
common problems, See troubleshooting 
concatenating multiple disk configuration 
files 
SPARC systems 109-111 
configuring 
disk configuration file creation 
multiple disks 109-111 
SPARC systems 107-108 
hands-off network installation 
requirements 20 
hardware and peripheral devices x 
peripheral devices 
after installation 143 
preconfiguring 
default locale for network 
installation 40-45 
hands-off network installation 
requirements 20 
preserving software configurations 
during upgrade installation* 
114 | 
copying 
boot information with setup_ 
install_server 167 
disk configuration file to JumpStart 
directory 107 


JumpStart directory files using finish 
scripts 101 
JumpStart installation files from CD 
58, 62, 64 
Solaris boot diskette _ 
using Volume Management 54— 
55, 59-60 
without Volume Management 
56-57, 60-61 
Solaris CD to install server’s local 
disk 21, 22, 25 
Core System Support software 
cluster name 73 
hard disk space required 10 
cost-effective installation method 11 


Could not mount filesystem 
message 171 
cp command 
See also copying 
copying disk configuration file to 
JumpStart directory 107 
copying JumpStart directory files 
using finish scripts 101 
copying JumpStart installation files 
from CD 64 
creating JumpStart directory 162 
CPUs (processors) | 
rule keywords 88 
creating 
See also adding 
boot server on subnet 27-29 - 
disk configuration files 
SPARC multiple disks 109-111 
SPARC systems 107-108 
/etc/locale file 42 
install server 22-26 
new system setup 22-23 
overview 22 
procedure 24—26 
JumpStart directory 49 
diskette for SPARC systems 59-62. 
diskette for x86 systems 53-58 
server 62-65 
local file systems 77-78 
profiles 49, 67-68 


SPARC: Installing Solaris Software — November 1995 


derived 98-99 
rules file 49, 82-85 
rules .ok file 49, 82, 87, 93 
UFS file system 60 


crontabs documentation 142 
.cshrc file 102 
custom JumpStart installation 131-136 


See also JumpStart directory; 
JumpStart installation 

advantages 11, 48 

AutoClient systems 136 

booting and installing 131-136 
booting the system 133-135 
CD-ROM drive preparation 132 
completing the upgrade 137-138 
installation process 135 
starting OpenWindows 136 
task map 15 

dataless clients 136 

defined 47 

described 11-12 

diskless clients 136 

examples 161—168 
booting and installing 168 
check script 165 
eng_profile creation 163 
engineering systems setup 166 
JumpStart directory creation 162 


finish scripts 100-104 

overview 97 

pfinstall command 104-106 

site-specific installation 
programs 111 

overview 50-52 
preparing 47-95 

enabling JumpStart directory 
access 65-67 

installation process 50-52 

JumpStart directory creation on 
server 62-65 

JumpStart directory on diskette 
for SPARC systems 59-62 

JumpStart directory on diskette 
for x86 systems 53-58 

profile creation 67-68 

profile examples 69-71 

profile keywords and value 
descriptions 72-81 

rootdisk value 91-93 

rule examples 86 

rule keywords and value 
descriptions 88-91 

rules file creation 82-85 

rules file information 87 

rules file validation 93-95 

swap size 82 


JumpStart directory sharing 163 tasks 49 
marketing systems setup 167-168 profile server 
marketing_profile creation OS servers 35 

164 standalone systems 34 
networked 52 task map 15 
non-networked 51 
rules file editing 164-165 D 


site setup 161-162 © 
standalone system 51 
hands-off installation 


-D option of pfinstall command 105 
-d option of pfinstall command 106 


described 11 daemons 
requirements 20 tf£tpd 174 
JumpStart directory 38 dataless clients 
No network boot server message custom JumpStart installation 
| 170 | completion 136 


described 7 


optional features 97-111 
| filesys profile keyword 76 


begin scripts 98-99 
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future Solaris releases (after 2.5) and 8 
interactive installation completion 
130 
network installation server setup 30- 
37 
host, adding 36 
install server setup 37-39 | 
name service selection 32 
overview 31 
server support needed 30 
OpenWindows not available 175 
software requirements 8 
system identification labels 
SPARC systems 155-157 
x86 systems 155—?? 
upgrade installation 115 
dd command 54-55, 56-57 
See also copying 
de locale name 44, 79 
decimal fdisk partition type 75 
defaults 
derived profile name 99 
locale 
preconfiguring using NIS name 
service 40—42 
preconfiguring using NIS+ name 
service 43-45 
partitioning 81 
designating disks 81 
excluding disks 74 
SI_CONFIG_DIR variable setting 101 
software group installed 73 
delete fdisk partition type 75 
deleting 
clusters when upgrading 73 
fdisk partitions 75 
packages from software groups 80 
software after installation 141 
derived profiles 98-99 
DeskSet software 10 
desktop, displaying 136 | 
interactive installation 130 
JumpStart installation 123 
Developer System Support software 


cluster name 73 
hard disk space required 10 
Developer System Support software 
profile example 69 
device access documentation 143 
df -a command 114 
dfstab file 63, 163 
directories 
changing 
to JumpStart directory 94 
to mounted CD 58, 62, 64 
to Solaris CD image on local disk 
57, 61, 64 
JumpStart 
adding files with finish scripts 
101 
copying files 101, 107 
copying installation files from 
CD 58, 62, 64 
creating 49, 162 
creating for SPARC systems 59- 
62 
creating for x86 systems 53-58 
enabling access 49, 65-67 
file name truncation 58 
install server setup 38 
permissions 53, 63 
rules file example 83 
sharing 63, 163 
disaster recovery when booting from CD 
176 
See also troubleshooting 
disk configuration files 
copying to JumpStart directory 107 
creating 
SPARC multiple disks 109-111 
SPARC systems 107-108 
described 104, 107 
disk drives, See CD-ROM drives; diskette 
- drives; hard disks 


diskette drives 


~ documentation 142, 143 


diskettes 
copying Solaris boot diskette 
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using Volume Management 54— 
55, 59-60 
without Volume Management 
56-57, 60-61 
ejecting 
SPARC systems 55 
x86 systems 55, 56 
formatting 55, 56, 60, 61 
JumpStart directory 
access 65 
creating for SPARC systems 59- 
62 
creating for x86 systems 53-58 
mounting 57, 61 
diskless clients 
custom JumpStart installation 
completion 136 
described 7 
interactive installation completion 
130 
OpenWindows not available 175 
platforms 72 


Solaris already installed on OS server 


8 
swap space 72 
system identification labels 
SPARC systems 155-157 
x86 systems 155-?? 
disksize rule keyword 
description and values 88 
rootdisk matching 92 
display 
interface for interactive installation 
129 
resetting after I/O interrupts 21 
tip line connection and interactive 
installation 127 
displaying 
mounted file systems 21 
platform name 21 
system information 21, 142 
distribution software group profile 
examples 70 


DNS (Domain Name Service) 32 


Index 


documentation needed after installation 
141-143 


Domain Name Service (DNS) 32 
domainname rule keyword 88 


domains 
default locale 42 
rule keyword 88 


dontuse profile keyword 
description and values 74 
usedisk and 81 


DOSHUGE fdisk partition 74 
DOSOS12 fdisk partition 74 
DOSOS16 fdisk partition 74 
dosprimary fdisk partition type 74 


E 

ejecting diskettes 
SPARC systems 55 
x86 systems 55, 56 


ellipsis points (...) rule field 84 
enabling JumpStart directory access 49, 
65-67 
End User AnswerBook 142 
End User System Support software 
cluster name 73 
hard disk space required 10 
eng_profile example 163 
English locale value 44 
Entire distribution plus OEM support 
software 
cluster name 73 
Entire distribution software 
cluster name 73 


- equals sign (=) in profile field 98 


erasing, See deleting 
error messages 
See also troubleshooting 
boot: cannot open 
/kernel/unix 171 
Error: Unknown client 170 
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196 


file just loaded does not 
appear to be 
executable 171-172 
I/O interrupts 21 
le0O: No carrier - transceiver 
cable problem170 
No network boot server 170 
pkgrm: ERROR: class action 
script did not 
complete successfully 
171 
prom_panic: Could not mount 
filesystem171 
Timeout waiting for ARP/RARP 
packet 172 
WARNING: clock gained xxx days 
172 
WARNING: getfile: RPC failed: 
error 5: RPC Timed out 
66, 173 
Error: Unknown client message 170 
es locale name 44, 79 
/etc files, updating NIS or NIS+ tables 66 
/etc/bootparams file 
enabling JumpStart directory access 
66 
updating 174 
/etc/dfts/dfstab file 63, 163 
/etc/locale file 42 
/etc/mnttab file and UFS file system 
existence 60 
/etc/resolv.conf file 32 
/etc/shadow file 103 
/etc/vfstab file 
mount options 78 
preventing file systems from 
mounting during upgrade 
117 | 
Ethernet addresses 
displaying 21 
specifying 21 
Ethernet networks, See network 
installation; networked systems 
exclamation mark (!) rule field 84 


executing, See starting 
existing 

partitioning value 81 

size value for filesys 77 
explicit, partitioning value 81 


F 


failed upgrade 
cleaning up 137-138 
rebooting problems 176 
fdformat command 55, 56, 60, 61 
fdisk profile keyword 
description and values 74-75 
example 70 
file just loaded does not appear 
to be executable message 
171-172 
file servers for dataless clients 36 
files and file systems 
administration 142 
begin scripts output 98 
boot file documentation 142 
copying 
JumpStart directory files using 
finish scripts 101 
JumpStart installation files from 
CD 58, 62, 64 
Solaris boot diskette using 
Volume Management 54— 
55, 59-60 
Solaris boot diskette without 
Volume Management 56- 
57, 60-61 
creating local file systems 77-78 
displaying mounted file systems 21 
finish scripts output 100 
mounting remote file systems 76 
names on PCFS file systems 58 
preserving data 
existing data 78 
preventing mounting during 
upgrade 117 
symbolic links 116 
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unpreserved local modifications 
during upgrade 137-138 
remote access 142 
troubleshooting 
file just loaded does not 
appear to be 
executable message 
171-172 
prom_panic: Could not 
mount filesystem 
message 171 
UFS file system creation 60 
filesys profile keyword 
description and values 76-78 
examples 69-70 
local file systems 77-78 
remote file systems 76 
finish rule field 
described 85 
valid entries 87 
validation 93 
finish scripts 100-104 
adding files using 101 
defined 100 
important information 100 
output 100 
permissions 100 
root environment customization 102 
root password setting 102-104 
rule field 85 
site-specific installation programs 111 
uses 100 
finish.1log file 100 
floppy disks, See diskettes 
floppy drives 
documentation 142, 143 
format utility documentation 143 
formatting diskettes 55, 56, 60, 61 
fr locale name 44, 79 
free size value for filesys 77 
French locale value 44, 79 
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German locale value 44, 79 

getfile: RPC failed: error 5: 
RPC Timed out message 66, 173 

graphics monitor, See display 

Greenwich Meantime map 178 

groups, See software groups 
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halting a system 142 
hands-off installation 
See also custom JumpStart installation 
described 11 
requirements 20 
hard disks 
copying Solaris CD to install server 
22,20 
documentation 143 
interfaces supported 9 
local disks in networked systems 7 
managing use 142 
mounting 
displaying mounted file systems 
21 
remote file systems 76 
partitioning 
deleting fdisk partitions 75 
designating for partitioning 
default 81 
examples 69-70 
excluding for partitioning 
default 74 
profile keyword 81 
requirements for Solaris installation 
9-22, 9, 22-11 
rootdisk values 77, 91-93 
setting up 143 
size 
root space 72 
rule keywords 88, 91 
space available 25, 29 
space required for installation 9- 
11 
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swap space 
diskless client 72 
maximum size 82 
networked systems 7 
profile examples 69, 70 
upgrade installation and full disk 114 
hard links, unpreserved local 
modifications 138 
hardware - 
See also peripheral devices; specific 
hardware 
configuring x 
platform names and groups by 
system 159-160 
platforms supported 9 
requirements 9 
hexadecimal fdisk partition type 75 
host 
adding for network Solaris 
installation 34-36 
name 38, 89 
Host Manager 
adding hosts 
dataless clients 36 
OS servers 35 
standalone systems 34 
custom JumpStart installation 
completion 136 
described 21 
interactive installation completion 
130 | 
name service selection 32 
hostaddress rule keyword 88 
hostname rule keyword 
description and values 89 


advantages 11 
AutoClient systems 136 
booting the system 133-135 
CD-ROM drive preparation 132 
dataless clients 136 
described 11-12 
diskless clients 136 
installation process 135 
starting OpenWindows 136 
task map 15 
install_type profile keyword 78 
interactive installation 125-130 
advantages 11 
AutoClient systems 130 
booting the system 127-128 
CD-ROM drive preparation 126 
dataless clients 130 
described 11~—12 
diskless clients 130 
installation process 128-129 
starting OpenWindows 130 
task map 14 
tip line connection and 127 
JumpStart installation 119-123 
advantages 11 
booting the system 123 
CD-ROM drive preparation 122 
checking for new system 120 
Customer Information sheet 120 
described 11-12 
installation process 123 
selecting software to install 121 
starting OpenWindows 123 
task map 13 
upgrade installation vs. 113 
work sheet 146-150 


example 86 install patches and upgrade installation 


114 


I | install server 


I/O interrupt error messages 21 
initial installation 
See also preparing for Solaris 
installation 
custom JumpStart installation 131- 
136 
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copying Solaris CD to local disk 21, 22, 
25 


creating 22-26 
new system setup 22-23 
overview 22 
procedure 24—26 


described 18 
network installation setup 37-39 
on subnet other than system to be 
installed 26-29 
requirement for network installation 
18-19 
specifying for network installation 
OS servers 35 
standalone systems 34 
system types applicable 22 
install_config command 66 
install_type profile keyword 
description and values 78 
examples 69-??, 71, ??-71 
requirement 67, 69 
testing profiles 104, 105-106 
creating disk configuration files 
107-2? 
Installation Notes xi 
installed rule keyword 
description and values 89 
rootdisk matching 92 
installing AnswerBooks 142 


Installing Solaris 
how to use ix 
intended audience ix 
organization x—?? 
related information xi 
installing Solaris software 
See also custom JumpStart installation; 
interactive installation; 
JumpStart installation; 
preparing for Solaris 
installation; upgrade 
installation 
booting phase 3 
choosing a method 11-12, 48 
defined 1 
documentation needed after 
installation 141-143 


interactive vs. automatic installation 3 


overview 
diagram 2-3 
task maps 12-15 
site-specific installation programs 111 


Index 


work sheets 145-153 
initial installation 146-150 
purposes and uses 145 
shaded areas 145 
upgrade installation 151-153 
Integrated Drive Electronics (IDE) 
interface, See IDE interface 
interactive installation 125-130 
See also preparing for Solaris 
installation 
advantages 11 
AutoClient systems 130 
booting the system 127-128 
CD-ROM drive preparation 126 
completing an upgrade 137-138 
dataless clients 130 
described 11-12 
diskless clients 130 
installation process 128-129 
starting OpenWindows 130 
task map 14 
tip line connection and 127 
IP addresses 
rule keyword 88 
specifying 21 
IPI interface, requirement 9 
it locale name 44, 79 
Italian locale value 44, 79 
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ja locale name 79 
Japanese locale value 79 
JumpStart directory 
adding files with finish scripts 101 
copying files 
disk configuration files 107 
installation files from CD 58, 62, 
64 
using finish scripts 101 
creating 49 | 
diskette for SPARC systems 59-62 
diskette for x86 systems 53-58 
example 162 
server 62-65 
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enabling access 49, 65-67 

file name truncation 58 

install server setup 38 

permissions 53, 63 

rules file example 83 

sharing 62-65, 163 

JumpStart installation 

See also custom JumpStart installation 

advantages 11 

booting and installing 119-123 
booting the system 123 
CD-ROM drive preparation 122 
checking for new system 120 
Customer Information sheet 120 
installation process 123 
selecting software to install 121 
starting OpenWindows 123 
task map 13 

described 11-12 

task map 13 
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karch rule keyword 89 

kernel architecture, See platforms 

kernel location and upgrade installation 
115, 171 

keywords, See profile keywords; rule 
keywords 

ko locale name 79 

Korean locale value 79 


L 


labels, system identification 
SPARC systems 155-157 
x86 systems 155—?? 
language (locale) 
preconfiguring using NIS name 
service 40-42 
preconfiguring using NIS+ name 
service 43-45 
Latin America locale value 44, 79 
Le0; NO-Carriér- = transceiver 
cable problem message 170 


links 
hard 
unpreserved local modifications 
| during upgrade 138 
symbolic 
preserving during upgrade 116 
unpreserved local modifications 
during upgrade 138 
local disks, See hard disks 
locale file 42 
locale profile keyword 
description and values 79 
example 71 
locale, default 
preconfiguring using NIS name 
service 40-42 
preconfiguring using NIS+ name 
service 43—45 
locale.org_dir table, adding entries 44 
log files 
begin scripts output 98 
finish scripts output 100 
upgrade installation 137 
logical AND rule field 84 


M 


mail accounts, setting up 141 
mail directory 116 
make command 42 
Makefile file 41 
man pages 69, 71 
maps, task 
custom JumpStart installation 15 
interactive installation 14 
JumpStart installation 13 
marketing_profile example 164 
matching 
derived profiles 99 
order for rules 83, 86 
rootdisk values 91-93 


maxfree size value for fdisk 75 
memory 
displaying amount installed 21 
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minimum required 9 
rule keyword 86, 89 
setting size 105 

swap space size and 82 
virtual 9 


memsize rule keyword 
description and values 89 
example 86 
messages, See troubleshooting 
microprocessors 
rule keywords 88 
minus sign (-) 
in begin and finish scripts 111 
in rules 87 
mkdir command 63 
mnttab file and UFS file system existence 
60 
model name, displaying 21 
model rule keyword 
description and values 90 
example 86 
modem documentation 143 
monitor, See display 
mount command 21, 61 
mounting 
begin script caution 98 
diskettes 57, 61 
displaying mounted file systems 21 
OpenWindows file system 175 
remote file systems 76 
Solaris CD 24, 27, 58, 62, 64 
by Solaris installation 100 
multiple disk configuration file 
SPARC systems 109-111 


multiple lines in rules 87 
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name server 18-19 
name service 


See also NIS; NIS+ 
Error: Unknown client message 
170 
Index 


hands-off network installation 
requirements 20 

selecting 23 

selecting for network Solaris 
installation 32 

specifying 21 

names / naming 

See also name service 

derived profile names 99 

host name 38, 89 

PCFS file name truncation 58 

profile names 68 

rules file 83, 87 

software group cluster names 73 

system model names 90 

system platform name determination 
21,159 


network installation 
See also custom JumpStart installation; 
dataless clients; diskless 
clients; interactive 
installation; JumpStart 
installation 
custom JumpStart installation 
example 52 
task map 15 
described 17 
interactive installation task map 14 
JumpStart installation task map 13 
preparing 17-45 
boot server creation 27-29 
commands available 21 
hands-off installation 
requirements 20 
install server creation 22-26 
preconfiguring default locale 40- 


server setup 30-39 
servers required 18-19 
speeding up installations 22 
prom_panic: Could not mount 
filesystem message 171 
network number 91 


network rule keyword 
description and values 91 
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example 86 
networked systems 
determining if connected 6 
types 6-8 
news directory 116 
NIS 
default locale preconfiguration 40-42 
Error: Unknown client message 
170 © 
name service selection 32 
selecting 23 


Timeout waiting for ARP/RARP 


packet message 172 
updating tables corresponding to 
/etc files 66 
NIS+ 
default locale preconfiguration 43-45 
Error: Unknown client message 
170 
name service selection 32 
selecting 23 
Timeout waiting for ARP/RARP 
packet message 172 
updating tables corresponding to 
—— /etc files 66 
NIS+ and DNS Setup and Configuration 
Guide 23 
nistbladm command 43-44 
No carrier ~ transceiver cable 
problem message 170 


No network boot server message 170 
num_clients profile keyword 79 


O 


ok prompt, changing from > prompt 127, 
133 

opening, See starting 

openwin command 
custom JumpStart installation 136 
interactive installation 130 
JumpStart installation 123 
troubleshooting 175 

OpenWindows software 


hard disk space requirements 10 
not available to diskless or dataless 
clients 175 
starting 
custom JumpStart installation 
136 
interactive installation 130 
JumpStart installation 123 
OS servers 
described 7, 18 
drive requirements for Solaris 
installation 9 
network installation server setup 
host, adding 35 
install server setup 37-39 
name service selection 32 
overview 31 
network installation setup 30-37 
server support required 30 
requirement for network installation 
18-19 
Solaris already installed 8 
system identification labels _ 
SPARC systems 155-157 
x86 systems 155-?? 
osname rule keyword 91 
output files 
begin scripts log 98 
finish scripts log 100 
upgrade log 137 
overlap value for filesys 78 
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-p option of check script 94 
package profile keyword 
description and values 80 
examples 69, 71 
partitioning 
deleting fdisk partitions 75 
designating disks 81 
examples 69-70 
excluding disks 74 
fdisk partitions 70, 74-75 
profile keyword 81 
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partitioning profile keyword 
description and values 81 _ 
designating disks 81 
PASSWD variable 103 
password, root 102-104 
paths 
check script 94 
install server setup 38 
relative, for symbolic links 116 
PCFS file systems, file name truncation 58 
performance, increasing 142 
peripheral devices 
adding after installation 143 
configuring x 
maintaining after installation 143 
permissions 
begin scripts 98 
finish scripts 100 
JumpStart directory 53, 63. - 
pfinstall command 104-106 
See also disk configuration files 
disk configuration files 
described 104 
SPARC multiple disks 109-111 
SPARC systems 107-108 
options 105-106 
profile testing 105-106 
uses 104 
pkgrm: ERROR: class action 
script did not complete 
successfully message 171 
platform groups 159-160 
platforms 
diskless client 72 
group determination 159 
install server setup 38 
matching system attributes and 
profiles 82, 83, 86 
name determination 21, 159 
rule keywords 89 
selecting software to install 121 
supported 9 
system model names 90 


Index 


table of names and groups by system 
159-160 


pound sign (#) 


in profiles 68 
in rules 87 


preconfiguring, See configuring 
preparing for Solaris installation 


custom JumpStart installation 47-95 
advantages 11, 48 
described 11-12 
enabling JumpStart directory 
access 65-67 
example 161-168 
installation process 50-52 
JumpStart directory creation on 
server 62-65 
JumpStart directory on diskette 
for SPARC systems 59-62 
JumpStart directory on diskette 
for x86 systems 53-58 
profile creation 67-68 
profile examples 69-71 
profile keywords and value 
descriptions 72-81 
rootdisk value 91-93 
rule examples 86 
rule keywords and value 
descriptions 88-91 
rules file creation 82-85 
rules file information 87 
rules file validation 93-95 
swap size 82 
tasks 49 
importance of preparation 5 
interactive installation 
advantages 11 
described 11-12 
JumpStart installation 
advantages 11 
described 11-12 
network preparation 17—45 
boot server creation 27-29 
commands available 21 
hands-off installation 
requirements 20 
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204 


install server creation 22-26 
preconfiguring default locale 40- 
45 
server setup 30-39 
servers required 18-19 
system preparation 5-15 
backing up 11 
choosing installation method 11- 
12- 
disk space requirement 9-11 
hardware requirements 9 
network connection 
determination 6 
system type determination 6-8 
task maps (installation) 12-15 
tasks (preparatory) 5 
upgrade installation 113-117 
backing up 115 
determining upgrade availability 
113-114 
preserving local modifications 
116-117 
work sheets 145-153 
initial installation 146-150 
purposes and uses 145 
shaded areas 145 
upgrade installation 151-153 
preserve value for filesys 78 
preserving data 
existing data during installation 78 
preventing file systems from 
mounting during upgrade 
117 
symbolic links 116, 117 
unpreserved local modifications 
during upgrade 137-138 
printers 
See also peripheral devices 
setting up 142 
problems, See troubleshooting 
processors | 
_ rule keywords 88 
profile keywords 72-81 
adding to profiles 68 
case sensitivity 68 


Glient arch 7/2 
client_root 72 
client__swap 72 
eluster 
description and values 73 
examples 69-71 
dontuse 
description and values 74 
usedisk and 81 
fdisk 
description and values 74-75 
example 70 
filesys 
description and values 76-78 
examples 69-70 
local file systems 77-78 
remote file systems 76 
install_type 
description and values 78 
examples 69—??, 71, ??-71 
requirement 67, 69 
Locale 
description and values 79 
example 71 | 
num_clients 79 
package 
description and values 80 
examples 69, 71 
partitioning 
description and values 81 
designating disks 81 
examples 69-70 
_ excluding disks 74 
system_type 
description and values 81 
examples 69-70 
usedisk 
description and values 81 
dontuse and 74 
profile server for custom JumpStart 
installation 
OS servers 35 
standalone systems 34 
profiles 
comments in 68 
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creating 49, 67-68 
derived profiles 98-99 
described 49, 67 
examples 69-71 
eng_profile 163 
marketing_profile 164 
matching systems to 82, 83, 86 
naming 68 
requirements 67, 68 
rule field 85 
testing 105-106 
disk configuration files 107—?? 
prom_panic: Could not mount 
filesystem message 171 
prtconf command 90 
prtvtoc command 
SPARC disk configuration file 
creation 107-108 
ps -ef | grep tf£tpd command 174 


R 

-r option of check script 94 

RAM, See memory 

recovery procedure 176 

release of Solaris software 
determining 114 


installed rule keyword 89 
osname rule keyword 91 
remote file systems 
accessing 142 
mounting 76 
remote Solaris installation, See network 
installation 
removing, See deleting 
requirements , 
hard disk space 9-11 
hardware 9 
network installation 
hands-off configuration 20 
servers 18-19, 22 
profiles 67, 68 
reset command 21 
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resetting display and terminal after I/O 
interrupts 21 
resolv.conf file 32 
restoring the root file system 176 
root (/) file systems 
determining existence 114 
networked systems 7 
profile example 70 
restoring (disaster recovery) 176 
value set by installation program 91- 
93 
root environment, customizing 102 
root password, setting 102-104 
rootdisk 
defined 91 
slice value for filesys 77 
value set by installation program 91- 
93 
rootdisk fdisk partition 74 
RPC. Tai leds error 53 «RPC Timed 
out message 66, 173 
RPC Timed out message 66, 173 
rule keywords 88-91 
any 
description and values 88 
example 86 
rootdisk matching 92 
arch 88 
disksize 
description and values 88 
rootdisk matching 92 
domainname 88 
hostaddress 88 
hostname 86, 89 
installed 
description and values 89 
rootdisk matching 92 
karch 89 
memsize 86, 89 
model 86, 90 
network 86, 91 
osname 91 
totaldisk 91 
validation 93 
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rule_keyword rule field 84 
rule_value rule field 84, 87 
rules 
derived profiles 98-99 
examples 86 
field descriptions 84-85 
matching order 83, 86 
multiple line rules 87 
rootdisk matching rules 91-93 
syntax 84 
testing validity 94 
rules file 
adding rules 83-84 
comments 87 
creating 49, 82-85 
custom JumpStart example 164-165 
described 49, 82 
example 83 
multiple line rules 87 
naming 83, 87 
syntax 84 
testing rules 94 
validating using check 49, 93-95 
custom JumpStart example 165 
derived profiles and 99 
rules.ok file 
comments and 87 
creating 49, 82, 87, 93 
described 87 
matching order for rules 83, 86 


running, See starting 


S 
-s option of add_install_client 
command 38, 167 
saving data during installation, See 
preserving data 
/sbin/setup_cd script 176 
Sbus, requirement 9 
scripts 
See also check script; finish scripts 
begin scripts 98-99, 111 
Bourne shell scripts in rule fields 85 


finish scripts 100-104, 111 
for disaster recovery when booting 
from CD 176 
network installation commands 21 
pkgrm: ERROR: class action 
script did not 
complete successfully 
message 171 
SCSI interface, requirement 9 
security 
documentation 142 
root password 102-104 
serial port documentation 143 


servers 
See also boot server; install server; OS 
servers 
file servers for dataless clients 36 
JumpStart directory creation 62-65 
name server 18-19 
network installation setup 
dataless client installation 31-33, 
36-37 
OS server installation 31-33, 35, 
37 
standalone installation 31-34, 37 
profile server for custom JumpStart 
installation 34, 35 
requirements for network installation 
18-19 
root space 72 
service access facility documentation 143 
set_root_pw finish script 102-104 
setup, See configuring; preparing for 
Solaris installation 
setup_cd script 176 
setup_install_server command 
boot server setup 29 
custom JumpStart example 167 
described 21 
install server setup 25 
shaded areas in work sheets 145 
shadow file 103 


share command | 
sharing JumpStart directory 63, 163 
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sharing OpenWindows file system 
175 
shareall command 64, 163 
sharing 
JumpStart directory 63, 163 
OpenWindows file system 175 
SI_CONFIG_DIR variable 101 
SI_PROFILE environment variable 99 
SI_SYS_STATE variable 103 
site-specific installation programs 111 
size 
fdisk partition 75 
hard disk 
root space 72 
rule keywords 88, 91 
space available 25, 29 
space required 9-11 
local file system 77 
memory 86, 89, 105 
swap space 
diskless client 72 
maximum size 82 
profile examples 69, 70 
tip window dimensions 127 
slices 
filesys values 77 
profile examples 69-70 
rule keyword 89 
Small Computer System Interface (SCSI), 
requirement 9 
SMD interface, requirement 9 
software groups 
cluster names for profiles 73 
profile examples 69-71 
specifying packages 80 
upgrading 73 
software, See Solaris software; third party 
software 
Solaris 1.x to Solaris 2.x Transition Guide xi 
Solaris boot diskette | 
copying using Volume Management 
54-55, 59-60 
copying without Volume 
Management 56-57, 60-61 


Index 


Solaris CD 
copying to install server’s local disk 
21,2220 
displaying mounted file systems 21 
image on local disk 57, 61, 64 
inserting into local drive 
custom JumpStart installation 
132 
interactive installation 126 
installation on systems without CD- 
ROM drives 17-18 
mounting 24, 27, 58, 62, 64 
software contained 2 
troubleshooting 
disaster recovery when booting 
from CD 176 
file just loaded does not 
appear to be 
executable message 
171-172 
No network boot server 
message 170 
prom_panic: Could not 
mount filesystem 
message 171 
solaris fdisk partition type 74, 75 
Solaris software 
See also Solaris CD 
adding after installation 141 
groups 
cluster names for profiles 73 
profile examples 69-71 
specifying packages 80 
upgrading 73 
hard disk space requirements 9-11 
platforms supported 9 
release or version 
determining 114 
installed rule keyword 89 
osname rule keyword 91 
Solstice AdminSuite 2.1 User’s Guide xi 
Solstice AutoClient 1.0 Administration Guide 
8 
solstice program, See Solstice System 
Management Base 
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Solstice System Management Base 
documentation 143 
Host Manager 21, 32 
starting 31 
Solstice System Management Base 2.1 User’s 
Guide 8 
SPARC systems 
hardware requirements 9 
JumpStart directory creation on 
diskette 59-62 
platform names and groups 159-160 
platforms supported 9 
speeding network installations 22 
square brackets [] rule field 84 
standalone systems 
custom JumpStart installation 
| example 51 
described 7 
identification labels 
SPARC systems 155-157 
x86 systems 155-2? | 
network installation server setup 30- 
37 
host, adding 34 
install server setup 37-39 
name service selection 32 
overview 31 
server support needed 30 
networked and non-networked 
systems 8 
profile examples 69-70 
Standard Time zones 177-178 
starting 
check script 94-95 
OpenWindows software 
custom JumpStart installation 
136 
interactive installation 130 
JumpStart installation 123 
Solstice System Management Base 31 
t£tpd daemon 174 
stopping a system 142 
stty command 127 
subnet 


boot server creation on 27-29 
install server and 26 
SunOS 4.x systems 
custom JumpStart installation task 
map 15 
interactive installation task map 14 
platform names and groups 159 
upgrading 113 
SUNWCal11 group 73 
SUNWCprog group 73 
SUNWCreq group 73 
SUNWCuser group 73 
SUNWCXall1 group 73 
sv locale name 44, 79 
swap file systems 
diskless client swap space 72 
memory size and 82 
networked systems 7 
profile examples 69, 70 
size determination 82 
swap value for filesys 78 
Swedish locale value 44, 79 
symbolic links 
preserving during upgrade 116 
unpreserved local modifications 
during upgrade 138 
SYS_MEMSIZE variable 105 
system accounting utilities profile 
example 70 
System Administration Guide, Volume I xi 
system architecture, See platforms 
system boot, See booting the system 
system identification labels 
SPARC systems 155-157 
x86 systems 155-—?? 
system information, displaying 21 
system types 6-8 
See also platforms 
system_type profile keyword 
description and values 81 
examples 69-70 
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Taiwanese locale value 79 
tape drive documentation 143 
task maps 
custom JumpStart installation 15 
interactive installation 14 
JumpStart installation 13 
terminals 
documentation 143 
resetting after I/O interrupts 21 
testing 
_ profiles 105-106 
disk configuration files 107—?? 
validating rules files 
custom JumpStart example 165 
derived profiles and 99 
testing rules 94 
using check 49, 93-95 
t£tpd daemon 174 
third party software, adding 141 
time zones 177-178 
timed out RPC error 173 
Timeout waiting for ARP/RARP 
packet message 172 
tip line connection and interactive 
installation 127 
totaldisk rule keyword 91 
transceiver cable problem message 
170 
troubleshooting 169-?? 
boot: cannot open 
/kernel/unix message 171 
booting from wrong server 174 
disaster recovery when booting from 
CD 176 
Error: Unknown client message 
170 
failed upgrade 137-138 
file just loaded does not 
appear to be 
executable message 171- 
172 
general installation problems 
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booting the system 174, 174—??, 
176 
OpenWindows doesn’t start 175 
rebooting after failed upgrade 
176 
I/O interrupt messages 21 
LeQs NO: Carrier = transceiver 
cable problem message 
170 
No network boot server message 
170 
pkgrm: ERROR: class action 
Scripu did: not 
complete successfully 
message 171 
prom panic: Could not. mount 
filesystem message 171 
Timeout waiting for ARP/RARP 
packet message 172 
WARNING: clock gained xxx days 
message 172 
WARNING: getfile: RPC failed: 
error 5: RPC Timed out 
message 66, 173 
truncated file names 58 
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UFS file system 
creating 60 
determining existence of 60 


Unable to install the system 
message 170 
uname -i command 21, 159 
uname -m command 159 
Unknown client error message 170 
unnamed value for filesys 78 
unshareall command 64, 163 
upgrade installation | 
See also preparing for Solaris 
| installation 
completing 137-138 
custom JumpStart installation 131- 
136 
AutoClient systems 136 
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booting the system 133-135 
CD-ROM drive preparation 132 
completing the upgrade 137-138 
dataless clients 136 
diskless clients 136 
installation process 135 
starting OpenWindows 136 
task map 15 
dataless clients 115 
failed upgrade 137-138, 176 
hard disk full 114 
initial installation vs. 113 
install patches and 114 
interactive installation 125-130 
AutoClient systems 130 
booting the system 127-128 
CD-ROM drive preparation 126 
completing the upgrade 137-138 
dataless clients 130 
diskless clients 130 
installation process 128-129 
starting OpenWindows 130 
task map 14 
tip line connection and 127 
log file 137 | 
overriding boot file location 115, 171 
preparing 113-117 
backing up 115 
determining upgrade availability 
113-114 
preserving local modifications 
116-117 
preserving other software 
configurations 114 
profile example 71 
profile keywords 
cluster 71,73 
install_type 71, 78 
locale 71, 79 
package 71, 80 
SunOS 4.x systems and 113 
unpreserved local modifications 137— 
| 138 
work sheet 151-153 


upgrade_cleanup file 137-138 


upgrade_log file 137 


_usedisk profile keyword 


description and values 81 
dontuseand 74 
user accounts, setting up 142 
/usr file systems 7 
/usr/bin/solstice program, See 
Solstice System Management 
Base 
/usr/openwin/bin/openwin 
command 
custom JumpStart installation 136 
interactive installation 130 
JumpStart installation 123 
troubleshooting 175 
Jusrv/sbin/install<sd/pfingstel) 
command, See pfinstall 
command 
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validating 
profiles 105-106 
disk configuration files 107—?? 
rules files 
custom JumpStart example 165 
derived profiles and 99 
testing rules 94 
using check 49, 93-95 
/var/mail directory 116 
/var/news directory 116 
/var/sadm/begin.1log file 98 
/var/sadm/finish.log file 100 
/var/sadm/install_data/upgrade_ 
cleanup file 137-138 
/var/sadm/install_data/upgrade_ 
log file 137 
/var/ypo/make command 42 
/var/yp/Makefile file 41 
variables 
PASSWD 103 
SI_CONFIG_DIR 101 
SI_PROFILE 99 
SI_SYS_STATE 103 
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SYS_MEMSIZE 105 Z 
version of Solaris software 
determining 114 
installed rule keyword 89 
osname rule keyword 91 
vfistab file 
mount options 78 
preventing file systems from 
mounting during upgrade 
117 
virtual memory requirements 9 
See also swap file systems 


zh locale name 79 
zh_TW locale name 79 
zones, time 177-178 


VMEbus, requirement 9 
volcheck command 54, 59, 60 
Volume Management 
changing directory to mounted CD 
58, 64 
copying 
JumpStart installation files from 
CD 58 
Solaris boot diskette 54—55, 59-60 
determining whether running 24, 28 
mounting diskettes 57 
Solaris CD file path and 24, 28 
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WARNING: clock gained xxx days 
message 172 
work sheets 145-153 
initial installation 146-150. 
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upgrade installation 151-153 


wrapping lines in rules 87 
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file name truncation 58 
JumpStart directory creation on 
diskette 53-58 
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Release 
Solaris 2.5 


Revision History 


Date 
November 1995 


Comments 


Change to Service Setup For Clients During Installation 

The Solaris installation program (interactive and custom JumpStart) 
no longer sets up services for clients. During installation, selecting 
the system type ‘OS server’ only allocates space for clients; to 
complete client set up you must use Solstice Host Manager after 
Solaris software is installed. 


New bootparams Keyword/Value 

A new bootparams keyword/value forces sysidtool to attempt to 
configure a specified name service (overriding the default NIS+), 
thus enabling clients to be set up for off-subnet servers. See 
bootparams(A4). | 


The bootparams keyword/ value has the following syntax: 
ns=[server] : nameservice | (netmask) ] 


This addition affects the etc/bootparams file, Solstice Host 
Manager, and add_install_client script (where -n <ns_string> 
is the string to put in the bootparams table). 


Change of Location of Diskless Client Booting Information 
Information on how to boot diskless clients has been moved to the 
System Administration Guide, Volume I 


Release 


Solaris 2.4 


Date 


October 1994 


Comments 


Solstice Host Manager Replaces add_install_client 

The Solstice Host Manager now supports remote installations, and 
is the recommended tool for setting up network install servers _ 
(instead of the add_install_client command). Solstice Host 
Manager can also now be used to set up custom JumpStart 
installations. 


Hardware Support Dropped 
The sun4 and sun4e hardware is no longer supported in Solaris 2.5 


Underlying Software Changes 

The /usr/kvm directory is replaced by the /usr/platform 
directory. Servers no longer have to export /usr/kvm for each 
supported platform, and clients do not have to mount the exported 
/usr/kvm directory appropriate for their platform. With 
/usr/platform, the same exported /usr file system can support 
all platforms. 


The terms, kernel architecture and architecture, have been replaced by 
the terms platform name (for example SUNW,S240), and platform 
group (for example, sun4m). 


Book Rewrite 

The System Configuration and Installation Guide was rewritten. 
Procedures for installing Solaris software for x86 and SPARC were 
separated into two books and the titles changed to: x86: Installing 
Solaris Software and SPARC: Installing Solaris Software. 


New Interfaces For Interactive Installations 
New graphical user interface (GUI) and character user interface 
(CUI) were added for installing Solaris software. 
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